Dashboard › cli › Session 0I6OpGxWG8Ew
0I6OpGxWG8Ewjx9tsPerform a read-only adversarial correctness review of the exact current working-tree patch in /home/byk/Code/getsentry/cli-pr-1558. Do not modify any file, branch, commit, index, or VCS state. Context: this worktree is based on PR #1558 head bbaa7b3b722b87f1bccfe84063269cbbcabe2741. User requested root-cause fix for docs usage/examples drift: Stricli command definitions must be authoritative. Review ALL source and test changes plus generated skill changes in git diff relative to HEAD. Focus on behavior regressions, API/output compatibility, optional positional rendering, structured example metadata, native help ordering, docs and skill generator fallback behavior, fragment validation semantics, wrapper typing, and missing deterministic regressions. Verify claims from actual code and tests. You may run read-only tests/checks, but do not edit. Report findings first with severity and exact file:line evidence. Classify each as PASS, CONCERN, or MUST-FIX. If no defects, state PASS explicitly and note residual risks. End exactly MERGE or DO-NOT-MERGE. Return a substantive report even if no findings.
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>
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md
No files found
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
.../src/fragments/commands/agent-conversation.md | 36 ----------- .../plugins/sentry-cli/skills/sentry-cli/SKILL.md | 42 ++++++------- .../skills/sentry-cli/references/alert.md | 6 +- .../sentry-cli/skills/sentry-cli/references/cli.md | 4 +- .../skills/sentry-cli/references/explore.md | 2 +- .../skills/sentry-cli/references/feedback.md | 2 +- .../skills/sentry-cli/references/init.md | 2 +- .../skills/sentry-cli/references/issue.md | 2 +- .../skills/sentry-cli/references/monitor.md | 2 +- .../sentry-cli/skills/sentry-cli/references/org.md | 2 +- .../skills/sentry-cli/references/project.md | 4 +- .../skills/sentry-cli/references/release.md | 4 +- .../skills/sentry-cli/references/replay.md | 2 +- .../skills/sentry-cli/references/repo.md | 2 +- .../skills/sentry-cli/references/team.md | 2 +- .../skills/sentry-cli/references/trace.md | 2 +- ...
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)
<path>/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md</path> <type>file</type> <content> 1: # Jared (Outpost agent) 2: 3: Autonomous GitHub coding agent. Work in `/workspace/repo`. 4: 5: ## Model tiers 6: 7: The primary model is chosen per event (see `src/agents/models.ts`): heavy for 8: code-producing situations, cheaper for lightweight ones. 9: 10: | Role | Subagent | Model | 11: | --- | --- | --- | 12: | Triage / plan / review (heavy) | (primary Jared) | Claude Opus 4.8 | 13: | Triage / plan / review (light) | (primary Jared) | xAI Grok 4.3 | 14: | Explore | `explore` | OpenAI gpt-5-mini | 15: | Implement | `implement` | Moonshot kimi-k2.7-code | 16: | Ship (commit/push/PR) | `ship` | xAI Grok (`grok-build-0.1`) | 17: 18: Pipeline: triage → explore → plan → implement → review → ship. 19: (`worker` is a deprecated alias of `implement`.) 20: 21: Operators also talk to Jared directly from the Outpost dashboard. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/.lore.md</path>
<type>file</type>
<content>
1: <!-- Managed by lore (https://github.com/BYK/loreai) — manual edits are imported on next session. -->
2:
3: ## Long-term Knowledge
4:
5: ### Architecture
6:
7: <!-- lore:01a02357-f0a8-7fdb-9e9d-b0710cfe65c9 -->
8: * **API output binary and HTTP contracts**: Always preserve strict output-mode and binary-safety contracts. `sentry api` must preserve `rawApiRequest()` status text; empty textual non-2xx bodies must produce an HTTP status/request fallback, and JSON mode must expose `{status, statusText, body}` so empty success and error responses are distinguishable. Binary `Uint8Array` successes bypass formatters and remain raw; binary errors emit only status/content-type/byte-count summaries, never bytes or JSON coercion. Prompts must never block scripted runs or interleave with stdout JSON.
9:
10: <!-- lore:019ef480-47f1-7708-80cb-514ac37a3fde -->
11: * **@sentry/symbolic 13.4.0 API surface: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/.cursor/rules/ultracite.mdc</path>
<type>file</type>
<content>
1: ---
2: description: Ultracite Rules - AI-Ready Formatter and Linter
3: globs: "**/*.{ts,tsx,js,jsx,json,jsonc,html,vue,svelte,astro,css,yaml,yml,graphql,gql,md,mdx,grit}"
4: alwaysApply: false
5: ---
6:
7: # Ultracite Code Standards
8:
9: This project uses **Ultracite**, a zero-config Biome preset that enforces strict code quality standards through automated formatting and linting.
10:
11: ## Quick Reference
12:
13: - **Format code**: `npx ultracite fix`
14: - **Check for issues**: `npx ultracite check`
15: - **Diagnose setup**: `npx ultracite doctor`
16:
17: Biome (the underlying engine) provides extremely fast Rust-based linting and formatting. Most issues are automatically fixable.
18:
19: ---
20:
21: ## Core Principles
22:
23: Write code that is **accessible, performant, type-safe, and maintainable**. Focus on clarity and explicit intent over brevity. ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.agents
No files found
I’ll trace metadata from command definitions through introspection and both generators, then compare every changed test and generated file. I’ll keep the worktree and Git state untouched.
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_08327345c0015wGuOgtQ65VjLp
readonly output?: OutputConfig<any>;
/**
* Whether the command requires authentication. Defaults to `true`.
*
* When `true` (the default), the command throws `AuthError("not_authenticated")`
* before executing if no credentials exist at all (no token or refresh token
* in the DB or env vars). Expired tokens with a valid refresh token pass the
* guard — the API client handles silent refresh. The auto-auth middleware in
* `cli.ts` catches the error and triggers the login flow.
*
* Set to `false` for commands that intentionally work without a token
* (e.g. `auth login`, `auth logout`, `auth status`, `help`, `cli upgrade`).
*
* Set to `"dsn"` for commands that authenticate via a Sentry DSN instead of
* a Bearer token (e.g. `event send`). These commands skip
* the token guard and the `.sentryclirc` URL trust ...
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
@@ -57,86 +57,98 @@ import {
} from "./formatters/output.js";
import { isPlainOutput } from "./formatters/plain-detect.js";
import { GLOBAL_FLAGS } from "./global-flags.js";
import { setInteractivePromptsAllowed } from "./interactive-prompts.js";
import {
LOG_LEVEL_NAMES,
type LogLevelName,
logger,
parseLogLevel,
setLogLevel,
} from "./logger.js";
import { setArgsContext, setFlagContext, withTracing } from "./telemetry.js";
/**
* Parse a string input as a number.
* Re-exported from Stricli for convenience. ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,212 +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 ...
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 ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
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 ...
<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/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -337,127 +337,127 @@ 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 ...
Found 42 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 7: formatCommandExamples,
Line 43: (listCommand as unknown as { __primaryUsage?: string }).__primaryUsage
Line 46: expect(list.examples).toContain(
Line 50: expect(view.examples).toEqual([
Line 55: expect(formatCommandExamples(view.examples)).toBe(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 200: (command as unknown as { __primaryUsage?: string }).__primaryUsage
Line 222: expect((command as unknown as { __examples?: unknown }).__examples).toEqual(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 239: expect(info.examples).toEqual(["sentry thing list myorg"]);
Line 250: __primaryUsage: "<name>:<kind>...",
Line 274: const cmd = makeCommand({ __examples: examples });
Line 280: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
320: \`\`\`bash
321: # OAuth login (recommended)
322: sentry auth
323:
324: # Or use an API token
325: sentry auth --token YOUR_SENTRY_API_TOKEN
326:
327: # Check auth status
328: sentry auth status
329: \`\`\``;
330: }
331:
332: /** Append a code block to a map entry, creating the array if needed */
333: function appendExample(
334: map: Map<string, string[]>,
335: key: string,
336: code: string
337: ): void {
338: const list = map.get(key) ?? [];
339: list.push(code);
340: map.set(key, list);
341: }
342:
343: /**
344: * Collect all command paths from `### \`sentry ...\`` headings in a token list.
345: * Initializes each path with an empty array in the examples map. ...
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/span/list.ts: Line 594: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/upload.ts: Line 245: optional: true, Line 252: optional: true, Line 258: optional: true, Line 266: optional: true, Line 272: optional: true, Line 278: optional: true, Line ...
Found 9 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 111: examples: string[]; Line 289: examples: string[] = [] Line 304: examples: cmd.__examples?.length /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/local.ts: Line 270: * Output examples: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts: Line 520: examples: string[], Line 542: examples: string[], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/widget/index.ts: Line 47: "Row-filling examples:\n" + /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
Found 2 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 63: customUsage: [USAGE],
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
80: {
81: long: "--help",
82: description: "Show help for a command",
83: },
84: {
85: long: "--version",
86: description: "Show version",
87: },
88: ];
89:
90: /**
91: * Generate the commands list dynamically from Stricli's route structure.
92: * This ensures help text stays in sync with actual registered commands.
93: */
94: function generateCommands(): HelpCommand[] {
95: // Cast to our introspection types — Stricli's generic types are compatible
96: const routeMap = routes as unknown as RouteMap;
97: const entries = routeMap.getAllEntries();
98:
99: return entries
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible ...
Found 19 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts:
Line 42: * // In parameters:
Line 312: * parameters: {
Line 407: parameters: mergedParams,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts:
Line 75: parameters: [
Line 136: * // In parameters:
Line 620: parameters: mergedParams,
Line 699: parameters: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 47: parameters: {
Line 57: __jsonSchema?: import("valibot").GenericSchema;
Line 62: __primaryUsage?: string;
Line 69: | { kind: "tuple"; parameters: readonly PositionalParam[] }
Line 291: const jsonFields = cmd.__jsonSchema
Line 292: ? extractSchemaFields(cmd.__jsonSchema)
Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 466: metadata.__primaryUsage ...
Found 4 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.");
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 186: customUsage: ["<name>:<kind>..."],
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 37: fullDescription?: string;
Line 46: fullDescription?: string;
Line 105: fullDescription?: string;
Line 298: fullDescription: cmd.fullDescription,
<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: ...
No files found
No files found
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>
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
node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc node_modules/.pnpm/@stricli+core@1.3.0
<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>
Found 23 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 93: interface DocumentationKeywords {
Line 110: interface DocumentationHeaders {
Line 145: interface DocumentationBriefs {
Line 147: * Documentation brief to be included alongside `--help` flag in help text.
Line 153: * Documentation brief to be included alongside `--helpAll` flag in help text.
Line 159: * Documentation brief to be included alongside `--version` flag in help text.
Line 165: * Documentation brief to be included alongside `--` escape sequence in help text. ...
<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> 1390: * - `false`: `"false"`, `"f"`, `"no"`, `"n"`, `"off"`, `"0"` 1391: * 1392: * Parsers are only executed when an input is provided, 1393: * so the empty string is treated as a truthy value (i.e. a flag that is present but has no value is treated as `true`). 1394: */ 1395: declare const looseBooleanParser: (input: string) => boolean; 1396: 1397: /** 1398: * Creates an input parser that checks if the input string is found in a list of choices. 1399: */ 1400: declare function buildChoiceParser<T extends string>(choices: readonly T[]): InputParser<T>; 1401: 1402: /** 1403: * Parses input strings as numbers. ...
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 2001: const { brief, fullDescription, customUsage } = docs;
Line 2005: if (customUsage) {
Line 2006: for (const usage of customUsage) {
Line 2022: yield fullDescription ?? brief;
Line 2113: get fullDescription() {
Line 2114: return builderArgs.docs.fullDescription;
Line 2134: const { brief, fullDescription, hideRoute } = docs;
Line 2151: yield fullDescription ?? brief;
Line 2233: get fullDescription() {
Line 2234: return docs.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>
1980: if (def.optional) {
1981: name = `[${name}]`;
1982: } else if (atLeastOneOptional) {
1983: name = ` ${name}`;
1984: }
1985: if (def.default) {
1986: const defaultKeyword = args.ansiColor ? `\x1B[2m${keywords.default}\x1B[22m` : keywords.default;
1987: suffix = `[${defaultKeyword} ${def.default}]`;
1988: }
1989: return [
1990: args.ansiColor ? `\x1B[1m${name}\x1B[22m` : name,
1991: args.ansiColor ? `\x1B[3m${def.brief}\x1B[23m` : def.brief,
1992: suffix ?? ""
1993: ];
1994: }),
1995: [" ", " "]
1996: );
1997: }
1998:
1999: // src/routing/command/documentation.ts
2000: function* generateCommandHelpLines(parameters, docs, args) {
2001: const ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
Line 893: // introspect.ts reads this to populate CommandInfo.jsonFields for help
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 37: fullDescription?: string;
Line 46: fullDescription?: string;
Line 55: * reads it to populate {@link CommandInfo.jsonFields}.
Line 102: export type CommandInfo = {
Line 105: fullDescription?: string;
Line 131: commands: CommandInfo[];
Line 139: | { kind: "command"; info: CommandInfo }
Line 280: * Build a {@link CommandInfo} from ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
670: ): string {
671: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
672: let syntax = `--${flag.name}`;
673: if (alias) {
674: syntax = `-${alias}, ${syntax}`;
675: }
676: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
677: syntax += " <value>";
678: } else if (flag.variadic) {
679: syntax += " <value>...";
680: }
681: const parts = [syntax];
682: if (flag.brief) {
683: parts.push(flag.brief);
684: }
685: if (flag.default !== undefined && flag.kind !== "boolean") {
686: parts.push(`(default: ${JSON.stringify(flag.default)})`);
687: }
688: return parts.join(" — ");
689: }
690:
691: /**
692: * Format a CommandInfo as human-readable text.
693: */
694: function formatCommandHuman(cmd: CommandInfo): string {
695: const lines: string[] = [];
696: const signature = ...
No files found
No files found
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
Found 33 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 484: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 130: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/log/view.ts: Line 512: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/log/list.ts: Line 730: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts: Line 384: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 575: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/local/run.ts: Line 359: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/send-envelope.ts: Line 26: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/schema.ts: Line ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts -- agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. Error: API request failed: 404 Not Found Endpoint: /organizations/--help/agents/conversations/ Not found ELIFECYCLE Command failed with exit code 30.
<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>
1880: if (flag.kind === "enum") {
1881: const choices = flag.values.join("|");
1882: suffixParts.push(choices);
1883: }
1884: if (hasDefault(flag)) {
1885: const defaultKeyword = args.ansiColor ? `\x1B[2m${keywords.default}\x1B[22m` : keywords.default;
1886: let defaultValue;
1887: if (Array.isArray(flag.default)) {
1888: if (flag.default.length === 0) {
1889: defaultValue = "[]";
1890: } else {
1891: const separator = "variadic" in flag && typeof flag.variadic === "string" ? flag.variadic : " ";
1892: defaultValue = flag.default.join(separator);
1893: }
1894: } else {
1895: defaultValue = flag.default === "" ? `""` : String(flag.default);
1896: ...
Found 1 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) {
<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>
1765: throw new SyntaxError(`${input} is not one of (${choices.join("|")})`);
1766: }
1767: return input;
1768: };
1769: }
1770:
1771: // src/parameter/flag/types.ts
1772: function hasDefault(flag) {
1773: return "default" in flag && typeof flag.default !== "undefined";
1774: }
1775: function isOptionalAtRuntime(flag) {
1776: return flag.optional ?? hasDefault(flag);
1777: }
1778:
1779: // src/parameter/formatting.ts
1780: function wrapRequiredFlag(text) {
1781: return `(${text})`;
1782: }
1783: function wrapOptionalFlag(text) {
1784: return `[${text}]`;
1785: }
1786: function wrapVariadicFlag(text) {
1787: return `${text}...`;
1788: }
1789: function wrapRequiredParameter(text) {
1790: return `<${text}>`;
1791: }
1792: ...
.env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation 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) ...
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
USAGE
sentry agent-conversation view [<org>/]<conversation-id>
sentry agent-conversation view --help
View the full transcript of an agent conversation.
The org is optional and auto-detected from your project context when
omitted. Prefix the ID with an org slug to target a specific org.
Examples:
sentry agent-conversation view conv-123 # View full transcript (organization auto-detected)
sentry agent-conversation view my-org/conv-123 # Explicit organization
sentry agent-conversation view my-org/conv-123 --json # JSON output
ALIASES
sentry agent-conversation show
FLAGS
-f [--fresh] Bypass cache, re-detect projects, and fetch fresh data [default = false]
[--json] Output as JSON [default = false]
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
180: lines.push(formatFlagRow(flag, aliases));
181: }
182: return lines.join("\n");
183: }
184:
185: // ---------------------------------------------------------------------------
186: // Page Generation
187: // ---------------------------------------------------------------------------
188:
189: /** Generate the auto-generated reference section for a single command */
190: function generateCommandSection(cmd: CommandInfo): string {
191: const lines: string[] = [];
192:
193: // Command heading
194: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
195: lines.push(`### \`${signature}\``);
196: lines.push("");
197: lines.push(cmd.brief);
198:
199: // Arguments table
200: if (cmd.positionals.length > 0) {
201: lines.push("");
202: lines.push(formatPositionalsTable(cmd.positionals));
203: }
204:
205: ...
<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" ...
Checked 15 files in 2s. No fixes applied.
(no output)
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
220: * Returns one entry per positional, with placeholder, brief, and whether
221: * the parameter is optional. Used by documentation generators to build
222: * argument tables.
223: *
224: * @param params - Stricli positional parameter definition
225: * @returns Array of positional info objects
226: */
227: export function extractPositionals(
228: params?: PositionalParams
229: ): PositionalInfo[] {
230: if (!params) {
231: return [];
232: }
233:
234: if (params.kind === "tuple") {
235: return params.parameters.map((p, i) => ({
236: placeholder: p.placeholder ?? `arg${i}`,
237: brief: p.brief ?? "",
238: optional: p.optional ?? false,
239: }));
240: }
241:
242: if (params.kind === "array") {
243: return [
244: {
245: placeholder: `${params.parameter.placeholder ?? "args"}...`,
246: brief: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
595: orgSlug,
596: teamSlug,
597: teamSource,
598: requestedPlatform: platform,
599: dsn,
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. Create several projects at once\n" +
616: "by passing multiple pairs as separate arguments. All projects share one ...
--- name: sentry-cli-agent-conversation version: 0.45.0-dev.0 description: List and view agent conversations requires: bins: ["sentry"] auth: true --- # Agent-conversation Commands List and view agent conversations ### `sentry agent-conversation list [<org>]` List recent agent conversations **Flags:** - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` - `-q, --query <value> - Search query` - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` **JSON Fields** (use `--json --fields` to select specific fields): | Field | Type | Description | |-------|------|-------------| | `conversationId` | string | | | `title` | string \| null | | | `flow` | array | | | `errors` | number | | | `llmCalls` | number | | | `toolCalls` | number | | | ...
Found 4 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts: Line 328: export function buildDeleteCommand< /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts: Line 544: export function buildListCommand< Line 631: export type OrgListCommandDocs = CommandDocumentation; Line 686: export function buildOrgListCommand<TEntity, TWithOrg>(
Found 98 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 154: const command = buildCommand({
Line 170: const command = buildCommand({
Line 205: const command = buildCommand({
Line 555: const command = buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts:
Line 78: export const startCommand = buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts:
Line 199: export const listCommand = buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 467: export const viewCommand = buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 99: export const logsCommand = buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts:
Line 24: export const showCommand = ...
Found 24 matches
/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/release/list.ts:
Line 631: export const listCommand = buildListCommand("release", {
/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/list.ts:
Line 680: export const listCommand = buildListCommand("project", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/delete.ts:
Line ...
21 21 packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md 3 3 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/repo.md 1 1 packages/cli/plugins/sentry-cli/skill...
Found 6 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 44: export type Command = {
Line 68: export type PositionalParams =
Line 73: export type PositionalParam = {
Line 80: export type PositionalInfo = {
Line 102: export type CommandInfo = {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 21: type CommandInfo,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
30:
31: /** A routing target is either a route map (group) or a command */
32: export type RouteTarget = RouteMap | Command;
33:
34: /** A route map groups subcommands under a named path segment */
35: export type RouteMap = {
36: brief: string;
37: fullDescription?: string;
38: getAllEntries: () => RouteMapEntry[];
39: /** Returns the default command if one is configured, undefined otherwise */
40: getDefaultCommand?: () => unknown;
41: };
42:
43: /** A leaf command with parameters */
44: export type Command = {
45: brief: string;
46: fullDescription?: string;
47: parameters: {
48: positional?: PositionalParams;
49: flags?: Record<string, FlagDef>;
50: aliases?: Record<string, string>;
51: };
52: /**
53: * JSON output schema attached by `buildCommand` when `output.schema` is set. ...
Found 18 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/list.ts:
Line 366: hintParts.push("No projects found.");
Line 410: `No project '${projectSlug}' found in organization '${org}'.\n` +
Line 421: hint: `No project '${projectSlug}' found matching platform '${flags.platform}'.`,
Line 496: hint = `No projects${platformCtx} in organization '${org}'.`;
Line 498: hint = `No projects found in organization '${org}'.`;
Line 585: `No project with this name found in organization '${scopedOrg}'`,
Line 588: : ["No project with this slug found in any accessible organization"];
Line 644: hint: `No project '${projectSlug}' found matching platform '${flags.platform}'.`,
Line 705: return result.hint ?? "No projects found.";
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 18: * org. Project names cannot contain whitespace. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
350: */
351: async function createProjectWithErrors(
352: opts: CreateProjectOpts
353: ): Promise<CreatedProjectDetails> {
354: const { orgSlug, teamSlug, name, platform } = opts;
355: try {
356: return await createProjectWithDsn(orgSlug, teamSlug, { name, platform });
357: } catch (error) {
358: if (!(error instanceof ApiError)) {
359: throw error;
360: }
361: if (error.status === 404) {
362: return await handleCreateProject404(opts);
363: }
364: return handleCreateApiError(error, opts);
365: }
366: }
367:
368: /** A validated project specification parsed from the command positionals. */
369: type ParsedProjectSpec = {
370: /** Explicit organization slug, when the name used org/name syntax. */
371: org?: string;
372: /** Project display name. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
125: let desc = flag.brief;
126: // Only append default if the brief doesn't already mention it
127: if (
128: flag.default !== undefined &&
129: flag.kind !== "boolean" &&
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151: ...
No files found
.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.
{
"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
},
{
...
Found 14 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 976: interface TypedCommandPositionalParameters_<ARGS extends BaseArgs, CONTEXT extends CommandContext> {
Line 980: readonly positional: TypedPositionalParameters<ARGS, CONTEXT>;
Line 982: type TypedCommandPositionalParameters<ARGS extends BaseArgs, CONTEXT extends CommandContext> = [] extends ARGS ? Partial<TypedCommandPositionalParameters_<ARGS, CONTEXT>> : TypedCommandPositionalParameters_<ARGS, CONTEXT>;
Line 986: type TypedCommandParameters<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = TypedCommandFlagParameters<FLAGS, CONTEXT> & TypedCommandPositionalParameters<ARGS, CONTEXT>;
Line 995: readonly positional?: PositionalParameters;
Line 1030: type TypedPositionalParameter<T, CONTEXT extends CommandContext = ...
<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>
990: * internally and should only be used after the types are checked.
991: */
992: interface CommandParameters {
993: readonly flags?: FlagParameters;
994: readonly aliases?: Aliases<string>;
995: readonly positional?: PositionalParameters;
996: }
997:
998: interface BasePositionalParameter<T, CONTEXT extends CommandContext> extends ParsedParameter<T, CONTEXT> {
999: /**
1000: * In-line documentation for this parameter.
1001: */
1002: readonly brief: string;
1003: /**
1004: * String that serves as placeholder for the value in the generated usage line.
1005: * Defaults to "argN" where N is the index of this parameter.
1006: */
1007: readonly placeholder?: string;
1008: /**
1009: * Default ...
No files found
417
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/issue.md: Line 409: # positional args, including org-qualified and project-alias forms
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Running tests with seed "1"
Test Files 1 passed (1)
Tests 9 passed (9)
Start at 23:02:21
Duration 4.20s (transform 2.95s, setup 71ms, import 3.87s, tests 65ms, environment 0ms)
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Running tests with seed "2"
Test Files 1 passed (1)
Tests 9 passed (9)
Start at 23:02:26
Duration 3.81s (transform 2.60s, setup 166ms, import 3.37s, tests 82ms, environment 0ms)
DEPRECATED `test.poolOptions` was removed in Vitest 4. ...
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 5 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 46: expect(list.examples).toContain(
Line 50: expect(view.examples).toEqual([
Line 55: expect(formatCommandExamples(view.examples)).toBe(
Line 88: test("maps bare group examples to the default subcommand", () => {
Line 110: test("the generated project reference retains create examples", async () => {
No files found
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/trial.md: Line 5: ```bash /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/trace.md: Line 7: ```bash Line 23: ```bash Line 36: ```bash Line 52: ```bash /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/team.md: Line 5: ```bash /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/status.md: Line 5: ```bash Line 21: ```bash Line 26: ```bash /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/span.md: Line 7: ```bash Line 26: ```bash Line 39: ```bash /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/sourcemap.md: Line 7: ```bash Line 20: ```bash Line 33: ```bash Line 68: ```bash /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/snapshots.md: Line 5: ...
src/commands/trace/view.ts:483: positional: {
src/commands/trace/view.ts:484: kind: "array",
src/commands/trace/view.ts:485: parameter: {
src/commands/trace/view.ts:486: placeholder: "org/project/trace-id",
src/commands/trace/view.ts:487: brief:
src/commands/trace/view.ts:488: "[<org>/<project>/]<trace-id> - Target (optional) and trace ID (required)",
src/commands/trace/view.ts:489: parse: String,
src/commands/trace/view.ts:490: },
src/commands/trace/view.ts:491: },
src/commands/trace/view.ts:492: flags: {
src/commands/trace/view.ts:493: web: {
src/commands/trace/view.ts:494: kind: "boolean",
src/commands/trace/view.ts:495: brief: "Open in browser",
src/commands/trace/view.ts:496: default: false,
src/commands/trace/logs.ts:129: positional: {
src/commands/trace/logs.ts:130: kind: "array",
src/commands/trace/logs.ts:131: parameter: {
src/commands/trace/logs.ts:132: placeholder: ...
Found 2 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 821: if (typeof positional.minimum === "number" && positionalIndex < positional.minimum) {
Line 824: positional.minimum,
<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>
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 = nextFlags[0].namedFlag;
796: }
797: return;
798: }
799: }
800: if (activeFlag) {
801: storeInput(flagInputs, config.caseStyle, activeFlag, input);
802: activeFlag = void 0;
803: } else {
804: if (positional.kind === "tuple") {
805: if (positionalIndex >= positional.parameters.length) {
806: throw ...
Found 61 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/types/dashboard.ts:
Line 486: * Clamps per-display-type limits to their maximums with a warning.
Line 492: // Clamp to per-display-type limit maximums
Line 501: `${widget.displayType} widgets support a maximum of ${maxLimit} rows. Clamping --limit from ${widget.limit} to ${maxLimit}.`
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/logs.ts:
Line 128: * Defaults to "30d" — the maximum log retention period.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/infrastructure.ts:
Line 369: * Sentry API's maximum items per page.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/debug-files.ts:
Line 324: `Skipping ${dif.name}: size ${dif.content.length} exceeds server maximum file size ${maxFileSize}`
Line 356: detail: `Exceeds server maximum file size of ${maxFileSize} bytes (was ${dif.content.length} bytes)`,
Line 361: * Clamp the ...
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. Hand-written fragment — examples, guides, tips (from docs/src/fragments/)
+ * 1. Auto-generated reference and examples from CLI metadata or env registry
+ * 2. Hand-written guides and tips from docs/src/fragments/
*
* The generated output is gitignored. Fragment files are the committed
- * source of truth for custom content.
+ * source of truth for content that cannot live in command definitions.
*
* Usage:
* tsx script/generate-command-docs.ts
@@ -25,6 +25,7 @@
import { mkdirSync, rmSync } from "node:fs";
import { access, readFile, writeFile } from ...
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 ...
Found 8 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 318: * @param docExamples - Optional examples loaded from documentation Line 323: docExamples: Map<string, string[]> = new Map() Line 335: const examples = docExamples.get(path) ?? []; Line 340: ...extractRouteGroupCommands(subTarget, nestedPrefix, docExamples) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts: Line 417: async function loadCommandExamples( 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>
385: if (token.type === "heading" && token.depth === 3) {
386: currentCmd = extractCommandPathFromHeading(token.text) ?? null;
387: }
388: if (token.type !== "code" || token.lang !== "bash") {
389: continue;
390: }
391: const code = token.text.trim();
392: if (currentCmd && examples.has(currentCmd)) {
393: appendExample(examples, currentCmd, code);
394: } else {
395: const target = matchExampleToCommand(
396: code,
397: commandPaths,
398: groupFallback,
399: defaultCommandPath
400: );
401: if (target) {
402: appendExample(examples, target, code);
403: }
404: }
405: }
406: }
407:
408: /**
409: * Load examples for a specific command group from docs using the `marked`
410: * AST parser. ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/app.ts:
Line 111: export const routes = buildRouteMap({
Line 410: export const app = buildApplication(routes, {
.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.
[
{
"path": "sentry help",
"positional": "<command...>",
"positionals": [
{
"placeholder": "command...",
"brief": "Command to get help for",
"optional": true
}
]
},
{
"path": "sentry build upload",
"positional": "<path...>",
"positionals": [
{
"placeholder": "path...",
"brief": "Path(s) to the build(s) to upload (APK, AAB, IPA, or XCArchive)",
"optional": true
}
]
},
{
"path": "sentry cli defaults",
"positional": "<key value...>",
"positionals": [
{
"placeholder": "key value...",
"brief": "Setting key and optional value",
"optional": true
}
]
},
{
"path": "sentry cli feedback",
"positional": "<message...>",
"positionals": [
...
.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.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/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 ...
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 203: return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-sdk.ts:
Line 300: return s.replace(/(^|-)([a-z])/g, (_, _sep, c: string) => c.toUpperCase());
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts:
Line 177: `sentry\\s+${routeName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:\\s*$|[^\\w-])`,
Line 187: const escapedLeaf = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -352,30 +352,30 @@ Authenticate with Sentry ### Org Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` ### Project Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
Found 7 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/upgrade.ts: Line 896: optional: true, Line 926: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/uninstall.ts: Line 440: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/setup.ts: Line 606: optional: true, Line 613: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/import.ts: Line 295: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/completion.ts: Line 46: optional: true,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/completion.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry cli completion <shell>
3: *
4: * Print the shell completion script to stdout. Unlike `cli setup`, which writes
5: * completion files to disk, this command lets users and package managers install
6: * completions however they like.
7: *
8: * Usage:
9: * sentry cli completion zsh > ~/.local/share/zsh/site-functions/_sentry
10: * eval "$(sentry cli completion bash)"
11: *
12: * When no shell is given, the current shell is detected from $SHELL.
13: */
14:
15: import type { SentryContext } from "../../context.js";
16: import { buildCommand } from "../../lib/command.js";
17: import { getCompletionScript } from "../../lib/completions.js";
18: import { ValidationError } from "../../lib/errors.js";
19: import { CommandOutput } from "../../lib/formatters/output.js";
20: import { detectShellType } from "../../lib/shell.js";
21:
22: export ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts:
Line 47: const isStrict = process.argv.includes("--strict");
Line 282: if (isStrict) {
Line 296: `\n${warnings.length} subcommand coverage warning(s)${isStrict ? " (treated as errors with --strict)" : ""}:\n`
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = docs.fullDescription ?? docs.brief;
434: return {
435: ...docs,
436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
437: };
438: }
439:
440: /** Convert extended command docs into native Stricli help documentation. */
441: function prepareNativeDocs(
442: docs: CommandDocumentation
443: ): StricliBuilderArgs<CommandContext>["docs"] {
444: const { examples, ...nativeDocs } = docs;
445: if (!examples?.length) {
446: return nativeDocs;
447: }
448:
449: const renderedExamples = examples
450: .map(({ description, command }) => ` ${command} # ...
Found 8 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 62: __primaryUsage?: string; Line 64: __examples?: readonly CommandExample[]; Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional), Line 304: examples: cmd.__examples?.length Line 305: ? cmd.__examples.map( /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 466: metadata.__primaryUsage = Line 470: metadata.__examples = docs.examples; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts: Line 122: entry.target.__primaryUsage ??
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible subcommand names and join with pipes
107: const subEntries = entry.target
108: .getAllEntries()
109: .filter((sub: RouteMapEntry) => !sub.hidden);
110: const subNames = subEntries
111: .map((sub: RouteMapEntry) => sub.name.original)
112: .join(" | ");
113: return {
114: usage: `sentry ${routeName} ${subNames}`,
115: description: brief,
116: };
117: }
118:
119: // Direct command - use any public syntax override before raw parameters
120: if (isCommand(entry.target)) {
121: const placeholder =
122: ...
<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/apps/cli-docs/src/fragments/commands/proguard.md</path> <type>file</type> <content> 1: 2: 3: ## Examples 4: 5: ```bash 6: # Compute the UUID for a ProGuard/R8 mapping file 7: sentry proguard uuid ./app/build/outputs/mapping/release/mapping.txt 8: 9: # Output as JSON (includes the file path) 10: sentry proguard uuid mapping.txt --json 11: ``` 12: 13: ## Important Notes 14: 15: - The UUID is **deterministically derived from the mapping file contents** — 16: identical files always produce the same UUID. This is the same value 17: Sentry uses to associate a mapping with obfuscated Android stack traces. 18: - This matches the UUID computed by the legacy `sentry-cli proguard uuid` 19: command byte-for-byte. (End of file - total 19 lines) </content>
> sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections -- --check > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-parser.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx ...
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 ...
> sentry@0.45.0-dev.0 test /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run test:unit -- test/commands/agent-conversation/list.test.ts test/lib/command.test.ts test/lib/introspect.test.ts test/script/generate-skill-markdown.test.ts --printConsoleTrace > sentry@0.45.0-dev.0 test:unit /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && vitest run test/lib test/commands test/types test/script --coverage -- test/commands/agent-conversation/list.test.ts test/lib/command.test.ts test/lib/introspect.test.ts test/script/generate-skill-markdown.test.ts --printConsoleTrace > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx ...
Found 98 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/schema.md: Line 14: **Arguments:** /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/api.md: Line 14: **Arguments:** /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/local.md: Line 29: **Arguments:** /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/init.md: Line 14: **Arguments:** /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/trial.md: Line 14: **Arguments:** Line 24: **Arguments:** /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/trace.md: Line 14: **Arguments:** Line 35: **Arguments:** Line 54: **Arguments:** /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/span.md: Line 14: **Arguments:** Line 35: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/monitor/run.ts</path> <type>file</type> <content> 90: /** Maximum time (ms) to wait for a check-in envelope to be sent. */ 91: const CHECKIN_SEND_TIMEOUT_MS = 30_000; 92: 93: /** 94: * Send a check-in envelope, swallowing (but logging) any error. 95: * 96: * Check-in delivery must never abort or stall the wrapped command, so: 97: * - Failures are non-fatal (logged, then continues). 98: * - A timeout prevents a slow/unreachable ingest endpoint from blocking 99: * the child process spawn or exit. ...
Found 6 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/monitor/run.ts:
Line 262: const monitorSlug = args[0];
Line 265: if (!monitorSlug) {
Line 271: if (command.length === 0) {
Line 302: monitorSlug,
Line 316: SENTRY_MONITOR_SLUG: monitorSlug,
Line 377: monitorSlug,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/monitor/run.ts</path>
<type>file</type>
<content>
250: aliases: {
251: e: "environment",
252: s: "schedule",
253: },
254: },
255: async *func(this: SentryContext, flags: RunFlags, ...rawArgs: string[]) {
256: const { cwd } = this;
257:
258: // The scanner consumes the "--" escape token (allowArgumentEscapeSequence
259: // is enabled in app.ts), but strip a leading one defensively in case it is
260: // ever passed through (e.g. via a wrapping shell).
261: const args = rawArgs[0] === "--" ? rawArgs.slice(1) : rawArgs;
262: const monitorSlug = args[0];
263: const command = args.slice(1);
264:
265: if (!monitorSlug) {
266: throw new ValidationError(
267: `No monitor slug provided. Usage: ${USAGE_HINT}`,
268: "monitor-slug"
269: );
270: }
271: if (command.length === 0) {
272: throw new ValidationError(
273: `No ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | (Showing lines 1-25 of 145. Use offset=26 to continue.) </content>
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 566: function generateFullCommandDoc(cmd: CommandInfo): string {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
550: return parts.join(" - ");
551: }
552:
553: /**
554: * Get the visible, non-global flags for a command.
555: * Excludes hidden flags, help, and globally-injected flags.
556: */
557: function getVisibleFlags(cmd: CommandInfo): FlagInfo[] {
558: return cmd.flags.filter((f) => !(f.hidden || GLOBAL_FLAG_NAMES.has(f.name)));
559: }
560:
561: // ---------------------------------------------------------------------------
562: // Reference File Generation (full detail)
563: // ---------------------------------------------------------------------------
564:
565: /** Generate full documentation for a single command (used in reference files) */
566: function generateFullCommandDoc(cmd: CommandInfo): string {
567: const lines: string[] = [];
568: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
569: lines.push(`### ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-parser.ts > sentry@0.45.0-dev.0 tsx ...
> sentry@0.45.0-dev.0 lint /home/byk/Code/getsentry/cli-pr-1558/packages/cli > biome check --no-errors-on-unmatched --error-on-warnings --max-diagnostics=none ./ Checked 1028 files in 55s. No fixes applied.
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
<path>/home/byk/Code/getsentry/cli-pr-1558/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 ...
.env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation 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) ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_0835c03bf0018UKPxcN6LPXF9e
index eb19074f4..847f6a7bd 100644
--- a/packages/cli/script/generate-skill-markdown.ts
+++ b/packages/cli/script/generate-skill-markdown.ts
@@ -1,37 +1,48 @@
/**
* Markdown parsing helpers shared by the skill generator and its tests.
*/
/** Matches a generated command heading and stops before positional usage. */
const COMMAND_HEADING_RE =
/^`sentry\s+([^<[`\s]+(?:\s+[^<[`\s]+)*)(?:\s*(?:<|\[)[^`]*)?`$/;
/** Extract the literal command path from a generated command heading. */
export function extractCommandPathFromHeading(
heading: string
): string | undefined {
const match = COMMAND_HEADING_RE.exec(heading);
return match?.[1] ? `sentry ${match[1]}` : undefined;
}
/** Find the command whose literal path appears in a loose example block. ...
Found 5 matches /home/byk/Code/getsentry/cli-pr-1558/package.json: Line 38: "check:fragments": "pnpm --filter sentry run check:fragments", /home/byk/Code/getsentry/cli-pr-1558/.lore.md: Line 26: * **check-fragments.ts: validates fragment files against actual route names**: \`script/check-fragments.ts\`: validates fragment files against actual route names (Check 1-4) AND validates subcommand coverage within fragments (Check 5). Check 5: for each route with >1 command, verifies fragment mentions each subcommand via a heading (outside fenced code blocks) or \`sentry \<route> \<subcommand>\` code reference. Default commands handled: if fragment contains bare \`sentry \<route>\`, the default command is covered. Default commands detected from route map (\`defaultCommand\` field in route index files). Fenced code block content stripped before heading scan to avoid false positives from bash comments. Warnings by default; \`--strict\` makes them errors. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/.github/workflows/ci.yml</path>
<type>file</type>
<content>
160: private-key: ${{ secrets.SENTRY_RELEASE_BOT_PRIVATE_KEY }}
161: - uses: actions/checkout@v6
162: with:
163: token: ${{ steps.token.outputs.token || github.token }}
164: # Same-repo PRs (token step succeeded): check out the branch head so
165: # the auto-commit step can push regenerated docs back. Fork PRs leave
166: # `ref` empty so checkout defaults to GITHUB_REF (the pull_request
167: # merge SHA, always fetchable from the base repo with github.token).
168: ref: ${{ steps.token.outcome == 'success' && (github.head_ref || github.ref_name) || '' }}
169: - uses: pnpm/action-setup@v4
170: - uses: actions/setup-node@v6
171: with:
172: node-version: ${{ env.NODE_VERSION_22 }}
173: - uses: actions/cache@v5
174: id: cache
175: with:
176: ...
<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> 486: // --------------------------------------------------------------------------- 487: // Level C: list command builder with automatic subcommand interception 488: // --------------------------------------------------------------------------- 489: 490: /** Base flags type (mirrors command.ts) */ 491: type BaseFlags = Readonly<Partial<Record<string, unknown>>>; 492: 493: /** Base args type (mirrors command.ts) */ 494: type BaseArgs = readonly unknown[]; 495: 496: /** 497: * Command function type that returns an async generator. 498: * 499: * Mirrors `SentryCommandFunction` from `command.ts`. All command functions 500: * are async generators — non-streaming commands yield once and return. ...
No files found
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
1 subcommand coverage warning(s):
⚠ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
All 37 command fragment files valid (36 routes + index)
All 1 top-level fragment(s) valid
Found 11 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-sdk.ts:
Line 380: positionalExpr = `positionals(${args})`;
Line 583: // Required flags make params required even with variadic positionals
Line 690: "function positionals(...values: (string | undefined)[]): string[] {",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts:
Line 147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
Line 148: if (positionals.length === 0) {
Line 153: lines.push("**Arguments:**");
Line 155: lines.push("| Argument | Description |");
Line 157: for (const p of positionals) {
Line 199: // Arguments table
Line 200: if (cmd.positionals.length > 0) {
Line 202: lines.push(formatPositionalsTable(cmd.positionals));
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
Found 2 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 63: customUsage: [USAGE],
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
1450: });
1451:
1452: const routeMap = buildRouteMap({
1453: routes: { test: makeCommand() },
1454: docs: { brief: "Test app" },
1455: });
1456: const app = buildApplication(routeMap, { name: "test" });
1457:
1458: // Human mode
1459: const ctx1 = createTestContext();
1460: await run(app, ["test"], ctx1 as TestContext);
1461: const humanOutput = ctx1.output.join("");
1462: expect(humanOutput).toContain("Org: sentry");
1463: expect(humanOutput).toContain("Detected from .env file");
1464:
1465: // JSON mode
1466: const ctx2 = createTestContext();
1467: await run(app, ["test", "--json"], ctx2 as TestContext);
1468: const jsonRaw = ctx2.output.join("");
1469: expect(jsonRaw).not.toContain("Detected from");
1470: expect(JSON.parse(jsonRaw)).toEqual({ org: "sentry" });
1471: });
1472:
1473: ...
Found 17 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/utils.test.ts:
Line 14: describe("JSDoc examples (canonical alignment)", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/arg-parsing.test.ts:
Line 57: // Representative examples for documentation (invariants covered by property tests)
Line 325: // Representative examples for documentation (invariants covered by property tests)
Line 326: describe("representative examples", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/issue-id.test.ts:
Line 58: describe("expandToFullShortId representative examples", () => {
Line 59: // Representative examples for documentation (invariants covered by property tests)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 239: expect(info.examples).toEqual(["sentry thing list myorg"]);
Line 263: test("prefers structured command examples over legacy document examples", () ...
<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 ...
<path>/home/byk/.local/share/opencode/tool-output/tool_0835c03bf0018UKPxcN6LPXF9e</path>
<type>file</type>
<content>
1: diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
2: index 36db22e1d..6384a649d 100644
3: --- a/packages/cli/script/check-fragments.ts
4: +++ b/packages/cli/script/check-fragments.ts
5: @@ -186,128 +186,131 @@ function fragmentMentionsSubcommand(
6: const proseOnly = stripCodeBlocks(content);
7: const escapedLeaf = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
8: const headingRe = new RegExp(`^#{1,4}\\s+.*\\b${escapedLeaf}\\b`, "im");
9: if (headingRe.test(proseOnly)) {
10: return true;
11: }
12:
13: return false;
14: }
15:
16: /**
17: * Build a map of route name → RouteInfo for routes with multiple subcommands.
18: * Standalone commands (single command matching `sentry <name>`) are skipped
19: * since there's nothing to check — the fragment covers the whole command. ...
<path>/home/byk/.local/share/opencode/tool-output/tool_0835c03bf0018UKPxcN6LPXF9e</path>
<type>file</type>
<content>
1500: * @returns The merged flags, ownership booleans, and keys to strip.
1501: */
1502: function mergeGlobalFlags(
1503: existingFlags: Record<string, unknown>,
1504: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
1505: outputConfig?: OutputConfig<any>
1506: ): {
1507: mergedFlags: Record<string, unknown>;
1508: commandOwnsOrg: boolean;
1509: commandOwnsProject: boolean;
1510: stripKeys: Set<string>;
1511: } {
1512: const commandOwnsJson = "json" in existingFlags;
1513: const commandOwnsOrg = "org" in existingFlags;
1514: const commandOwnsProject = "project" in existingFlags;
1515:
1516: const mergedFlags: Record<string, unknown> = { ...existingFlags };
1517: const stripKeys = new Set<string>(ALWAYS_STRIP);
1518:
1519: for (const [name, shape] of ...
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 33 matches /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/issue/merge.ts: Line 276: 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/debug-files/find.ts: Line 131: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts: Line 36: kind: ...
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 ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
180: "parameters" in target &&
181: !("getAllEntries" in target)
182: );
183: }
184:
185: // ---------------------------------------------------------------------------
186: // Extraction Functions
187: // ---------------------------------------------------------------------------
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. Create several projects at once\n" +
616: "by passing multiple pairs as separate arguments. All projects share one org.\n\n" +
617: "Projects are created under a team. ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -327,147 +327,147 @@ 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 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 81: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: Line 202: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/index.ts: Line 12: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 470: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 102: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 201: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/index.ts: Line 21: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/team/list.ts: Line 61: ...
(no output)
<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: ...
<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: ...
Found 30 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/time-range.ts:
Line 63: * they only change ~12×/year instead of daily. Keeps examples looking current
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 112: /** Canonical examples consumed by generated documentation. */
Line 113: readonly examples?: readonly CommandExample[];
Line 444: const { examples, ...nativeDocs } = docs;
Line 445: if (!examples?.length) {
Line 449: const renderedExamples = examples
Line 469: if (docs.examples?.length) {
Line 470: metadata.__examples = docs.examples;
Line 561: // Prepare command-owned examples before schema enrichment so JSON fields
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 63: /** Canonical documentation examples retained by `buildCommand`. */
Line 64: __examples?: readonly CommandExample[];
Line 111: examples: string[];
Line 284: * @param ...
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/script/check-fragments.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Validate doc fragment files.
4: *
5: * Ensures fragment files stay consistent with the CLI route tree:
6: * 1. Every route has a corresponding fragment file (+ index.md)
7: * 2. Every fragment file corresponds to an existing route (or is index.md)
8: * 3. Fragment files don't accidentally contain frontmatter or the generated marker
9: * 4. Top-level fragments (e.g., configuration.md) exist
10: * 5. Fragment content covers all subcommands in a route (warnings only)
11: *
12: * Usage:
13: * tsx script/check-fragments.ts # Warnings for missing subcommands
14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
15: */
16:
17: import { mkdirSync, readdirSync } from "node:fs";
18: import { access, readFile, writeFile } from "node:fs/promises";
19: import type { RouteInfo, RouteMap ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md: Line 18: | `[<name:platform...>]` | One or more project name and platform pairs | Line 123: # Every project is a name:platform pair; project names cannot contain whitespace
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: (Showing lines 1-30 of 145. Use offset=31 to continue.) </content>
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help.test.ts: Line 5: * command generation from routes, and contextual examples.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Help Output Tests
3: *
4: * Tests for the branded CLI help output including the ASCII banner,
5: * command generation from routes, and contextual examples.
6: */
7:
8: import { describe, expect, test } from "vitest";
9: import { bannerLinesForWidth, formatBanner } from "../../src/lib/banner.js";
10: import { introspectAllCommands, printCustomHelp } from "../../src/lib/help.js";
11: import { useTestConfigDir } from "../helpers.js";
12:
13: /** Strip ANSI escape sequences for content assertions */
14: // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape codes use control chars by definition
15: const ANSI_RE = /\u001B\[[0-9;]*m/g;
16: function stripAnsi(str: string): string {
17: return str.replace(ANSI_RE, "");
18: }
19:
20: /** Widest line (in code points) in a rendered banner, ignoring ANSI codes. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
500: export function rewriteHelpJsonToHelpCommand(
501: argv: readonly string[]
502: ): string[] | undefined {
503: let hasHelp = false;
504: const { hasJson, fields, extraPath } = parseHelpJsonFlags(argv);
505: for (const token of argv) {
506: if (token === "--") {
507: break;
508: }
509: if (token === "--help" || token === "-h") {
510: hasHelp = true;
511: }
512: }
513: if (!(hasHelp && hasJson)) {
514: return;
515: }
516: const rewritten = ["help", "--json", ...extraPath];
517: if (fields && fields.length > 0) {
518: rewritten.push("--fields", fields.join(","));
519: }
520: return rewritten;
521: }
522:
523: /**
524: * Scan the top-level flags forwarded past route resolution for `--json`,
525: * `--fields`, and any leftover non-flag command-path tokens. ...
Found 9 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 29: matchExampleToCommand,
Line 108: const CODE_BLOCK_REGEX = /```(\w*)\n([\s\S]*?)```/g;
Line 188: const pattern = new RegExp(CODE_BLOCK_REGEX.source, CODE_BLOCK_REGEX.flags);
Line 395: const target = matchExampleToCommand(
Line 477: async function extractRoutes(routeMap: RouteMap): Promise<RouteInfo[]> {
Line 488: const docExamples = await loadCommandExamples(
Line 496: commands: extractRouteGroupCommands(target, routeName, docExamples),
Line 500: const examples = docExamples.get(path) ?? [];
Line 801: const routeInfos = await extractRoutes(routeMap);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
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: string): string {
150: let result = markdown.replace(/^import\s+.*?;\s*$/gm, "");
151: result = result.replace(/^export\s+.*?;\s*$/gm, "");
152: result = result.replace(/<[A-Z][a-zA-Z]*[^>]*\/>/g, "");
153: result = result.replace(
154: /<[A-Z][a-zA-Z]*[^>]*>[\s\S]*?<\/[A-Z][a-zA-Z]*>/g,
155: ""
156: );
157: result = result.replace(/\n{3,}/g, "\n\n");
158: return result.trim();
159: }
160:
161: /** Extract a ...
<path>/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md</path> <type>file</type> <content> 1: # Jared (Outpost agent) 2: 3: Autonomous GitHub coding agent. Work in `/workspace/repo`. 4: 5: ## Model tiers 6: 7: The primary model is chosen per event (see `src/agents/models.ts`): heavy for 8: code-producing situations, cheaper for lightweight ones. 9: 10: | Role | Subagent | Model | 11: | --- | --- | --- | 12: | Triage / plan / review (heavy) | (primary Jared) | Claude Opus 4.8 | 13: | Triage / plan / review (light) | (primary Jared) | xAI Grok 4.3 | 14: | Explore | `explore` | OpenAI gpt-5-mini | 15: | Implement | `implement` | Moonshot kimi-k2.7-code | 16: | Ship (commit/push/PR) | `ship` | xAI Grok (`grok-build-0.1`) | 17: 18: Pipeline: triage → explore → plan → implement → review → ship. 19: (`worker` is a deprecated alias of `implement`.) 20: 21: Operators also talk to Jared directly from the Outpost dashboard. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
<path>/home/byk/Code/getsentry/cli-pr-1558/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: ...
No files found
No files found
No files found
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts --strict
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
.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.
node:internal/modules/run_main:107
triggerUncaughtException(
^
Error: Transform failed with 7 errors:
/tmp/opencode/check-fragments-base-1558.ts:24:27: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base-1558.ts:30:2: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base-1558.ts:36:19: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base-1558.ts:37:29: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base-1558.ts:94:18: ERROR: Top-level await is currently not supported with the "cjs" output format
... ...
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/.check-fragments-base-1558.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 2 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/agent-conversation.md
Not documented: list, view
Hint: add a heading or code example for each (e.g., "sentry agent-conversation list")
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-parser.ts > sentry@0.45.0-dev.0 tsx ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_08375e62d001qrRw2HMis4yEYN
*
* @throws {ContextError} When the conversation ID segment is empty.
*/
function parseConversationTarget(target: string): {
org?: string;
conversationId: string;
} {
const trimmed = target.trim();
const slashIdx = trimmed.indexOf("/");
if (slashIdx === -1) {
return { conversationId: trimmed };
}
const org = trimmed.slice(0, slashIdx);
const conversationId = trimmed.slice(slashIdx + 1);
if (!(org && conversationId)) {
throw new ContextError("Conversation ID", USAGE_HINT, []);
}
return { org, conversationId };
}
export const viewCommand = buildCommand({
docs: {
brief: "View an agent conversation transcript",
- customUsage: ["[<org>/]<conversation-id>"],
+ customUsage: [USAGE],
fullDescription:
"View the full transcript of an agent conversation.\n\n" +
"The org is optional and ...
<path>/home/byk/Code/getsentry/cli-pr-1558/.lore.md</path>
<type>file</type>
<content>
1: <!-- Managed by lore (https://github.com/BYK/loreai) — manual edits are imported on next session. -->
2:
3: ## Long-term Knowledge
4:
5: ### Architecture
6:
7: <!-- lore:01a02357-f0a8-7fdb-9e9d-b0710cfe65c9 -->
8: * **API output binary and HTTP contracts**: Always preserve strict output-mode and binary-safety contracts. `sentry api` must preserve `rawApiRequest()` status text; empty textual non-2xx bodies must produce an HTTP status/request fallback, and JSON mode must expose `{status, statusText, body}` so empty success and error responses are distinguishable. Binary `Uint8Array` successes bypass formatters and remain raw; binary errors emit only status/content-type/byte-count summaries, never bytes or JSON coercion. Prompts must never block scripted runs or interleave with stdout JSON.
9:
10: <!-- lore:019ef480-47f1-7708-80cb-514ac37a3fde -->
11: * **@sentry/symbolic 13.4.0 API surface: ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,212 +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 { ...
<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>
520: const aOrder = aIndex === -1 ? 999 : aIndex;
521: const bOrder = bIndex === -1 ? 999 : bIndex;
522: return aOrder - bOrder;
523: });
524: }
525:
526: // ---------------------------------------------------------------------------
527: // Markdown Formatting Helpers
528: // ---------------------------------------------------------------------------
529:
530: /** Format a flag for display in documentation */
531: function formatFlag(flag: FlagInfo, aliases: Record<string, string>): string {
532: const parts: string[] = [];
533: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
534: let syntax = `--${flag.name}`;
535: if (alias) {
536: syntax = `-${alias}, ${syntax}`;
537: }
538: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
539: syntax += " <value>";
540: } else if ...
<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>
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
.../src/fragments/commands/agent-conversation.md | 36 ----------- .../plugins/sentry-cli/skills/sentry-cli/SKILL.md | 42 ++++++------- .../skills/sentry-cli/references/alert.md | 6 +- .../sentry-cli/skills/sentry-cli/references/cli.md | 4 +- .../skills/sentry-cli/references/explore.md | 2 +- .../skills/sentry-cli/references/feedback.md | 2 +- .../skills/sentry-cli/references/init.md | 2 +- .../skills/sentry-cli/references/issue.md | 2 +- .../skills/sentry-cli/references/monitor.md | 2 +- .../sentry-cli/skills/sentry-cli/references/org.md | 2 +- .../skills/sentry-cli/references/project.md | 4 +- .../skills/sentry-cli/references/release.md | 4 +- .../skills/sentry-cli/references/replay.md | 2 +- .../skills/sentry-cli/references/repo.md | 2 +- .../skills/sentry-cli/references/team.md | 2 +- .../skills/sentry-cli/references/trace.md | 2 +- ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -186,128 +186,131 @@ function fragmentMentionsSubcommand(
const proseOnly = stripCodeBlocks(content);
const escapedLeaf = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
const headingRe = new RegExp(`^#{1,4}\\s+.*\\b${escapedLeaf}\\b`, "im");
if (headingRe.test(proseOnly)) {
return true;
}
return false;
}
/**
* Build a map of route name → RouteInfo for routes with multiple subcommands.
* Standalone commands (single command matching `sentry <name>`) are skipped
* since there's nothing to check — the fragment covers the whole command. ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 37: fullDescription?: string;
Line 46: fullDescription?: string;
Line 105: fullDescription?: string;
Line 298: fullDescription: cmd.fullDescription,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts:
Line 81: fullDescription:
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts:
Line 202: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
280: * Build a {@link CommandInfo} from a Stricli Command.
281: *
282: * @param cmd - The Stricli command to introspect
283: * @param path - Full command path (e.g. "sentry issue list")
284: * @param examples - Optional usage examples
285: */
286: export function buildCommandInfo(
287: cmd: Command,
288: path: string,
289: examples: string[] = []
290: ): CommandInfo {
291: const jsonFields = cmd.__jsonSchema
292: ? extractSchemaFields(cmd.__jsonSchema)
293: : undefined;
294:
295: return {
296: path,
297: brief: cmd.brief,
298: fullDescription: cmd.fullDescription,
299: flags: extractFlags(cmd.parameters.flags),
300: positional:
301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
302: positionals: extractPositionals(cmd.parameters.positional),
303: aliases: cmd.parameters.aliases ?? ...
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 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts: Line 25: fullDescription:
Found 53 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/time-range.ts:
Line 63: * they only change ~12×/year instead of daily. Keeps examples looking current
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 112: /** Canonical examples consumed by generated documentation. */
Line 113: readonly examples?: readonly CommandExample[];
Line 444: const { examples, ...nativeDocs } = docs;
Line 445: if (!examples?.length) {
Line 449: const renderedExamples = examples
Line 469: if (docs.examples?.length) {
Line 470: metadata.__examples = docs.examples;
Line 561: // Prepare command-owned examples before schema enrichment so JSON fields
Line 893: // introspect.ts reads this to populate CommandInfo.jsonFields for help
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 55: * reads it to populate {@link CommandInfo.jsonFields}. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
680: }
681: const parts = [syntax];
682: if (flag.brief) {
683: parts.push(flag.brief);
684: }
685: if (flag.default !== undefined && flag.kind !== "boolean") {
686: parts.push(`(default: ${JSON.stringify(flag.default)})`);
687: }
688: return parts.join(" — ");
689: }
690:
691: /**
692: * Format a CommandInfo as human-readable text.
693: */
694: function formatCommandHuman(cmd: CommandInfo): string {
695: const lines: string[] = [];
696: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
697: lines.push(signature);
698: lines.push("");
699: lines.push(` ${cmd.brief}`);
700:
701: const visibleFlags = cmd.flags.filter((f) => !f.hidden);
702: if (visibleFlags.length > 0) {
703: lines.push("");
704: lines.push(" Flags:");
705: for (const flag of visibleFlags) {
706: lines.push(` ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts -- agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. Error: API request failed: 404 Not Found Endpoint: /organizations/--help/agents/conversations/ Not found ELIFECYCLE Command failed with exit code 30.
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Validate doc fragment files.
4: *
5: * Ensures fragment files stay consistent with the CLI route tree:
6: * 1. Every route has a corresponding fragment file (+ index.md)
7: * 2. Every fragment file corresponds to an existing route (or is index.md)
8: * 3. Fragment files don't accidentally contain frontmatter or the generated marker
9: * 4. Top-level fragments (e.g., configuration.md) exist
10: * 5. Fragment content covers all subcommands in a route (warnings only)
11: *
12: * Usage:
13: * tsx script/check-fragments.ts # Warnings for missing subcommands
14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
15: */
16:
17: import { mkdirSync, readdirSync } from "node:fs";
18: import { access, readFile, writeFile } from "node:fs/promises";
19: import type { RouteInfo, RouteMap ...
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help.test.ts: Line 5: * command generation from routes, and contextual examples.
{"baseRefName":"main","baseRefOid":"9d0901b10a154ae79220a9f99f463a024908ceb5","body":"The agent-conversation reference currently shows `sentry agent-conversation view my-org conv-123`, but `view` accepts one `[<org>/]<conversation-id>` positional argument. The list and view headings also make the organization appear mandatory even though both support detection.\n\nCorrect the authoritative examples to use `my-org/conv-123`, include the detected-organization form, and add command-specific usage metadata. Regenerate the skill index/reference with the existing generator. Command execution and argument parsing are unchanged.\n\nValidation:\n\n- Both new documentation regressions fail against current main before the correction.\n- Generated API schema, SDK, command docs and skills through the existing scripts.\n- 101 focused command, API, formatter and documentation tests passed across five files.\n- Biome checked the three TypeScript files with no fixes or ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help agent-conversation list --json
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_083842709001ITESNZBzF0xO6H
// document the login path.
if (name === "default") {
return "login";
}
return name;
}
}
return;
}
const SKILL_DIR = "plugins/sentry-cli/skills/sentry-cli";
const OUTPUT_PATH = `${SKILL_DIR}/SKILL.md`;
const REFERENCES_DIR = `${SKILL_DIR}/references`;
const INDEX_JSON_PATH = `${DOCS_PUBLIC}/.well-known/skills/index.json`;
const DOCS_PATH = DOCS_CONTENT;
/** Read version from package.json for YAML frontmatter */
async function getPackageVersion(): Promise<string> {
const pkg = JSON.parse(await readFile("package.json", "utf-8"));
return pkg.version;
}
/** Regex to match YAML frontmatter at the start of a file */
const FRONTMATTER_REGEX = /^---\n[\s\S]*?\n---\n/;
/** Regex to match code blocks with optional language specifier */
const CODE_BLOCK_REGEX = /```(\w*)\n([\s\S]*?)```/g;
/** Regex ...
## 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 agent-conversation view my-org/conv-123 --json ``` diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts index cdc8865be..8c9ce6332 100644 --- a/packages/cli/script/generate-command-docs.ts +++ b/packages/cli/script/generate-command-docs.ts @@ -1,309 +1,316 @@ #!/usr/bin/env tsx /** * Generate Command ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
Found 3 matches /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;
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path>
<type>file</type>
<content>
500: * are async generators — non-streaming commands yield once and return.
501: */
502: type ListCommandFunction<
503: FLAGS extends BaseFlags,
504: ARGS extends BaseArgs,
505: CONTEXT extends CommandContext,
506: > = (
507: this: CONTEXT,
508: flags: FLAGS,
509: ...args: ARGS
510: // biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system
511: ) => AsyncGenerator<unknown, CommandReturn | void, undefined>;
512:
513: /**
514: * Options for controlling which flags {@link buildListCommand} auto-injects.
515: *
516: * By default, `buildListCommand` adds `--fresh`, `--cursor`, and their aliases
517: * (`-f`, `-c`). Use these options to opt out when a command has conflicts. ...
Found 3 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;
Line 405: return buildCommand({
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts: Line 552: readonly docs: CommandDocumentation; Line 688: docs: OrgListCommandDocs,
Found 11 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 495: brief: target.brief,
Line 503: brief: target.brief,
Line 544: if (flag.brief) {
Line 545: parts.push(flag.brief);
Line 571: lines.push(cmd.brief);
Line 634: const description = route.brief;
Line 652: lines.push(route.brief);
Line 676: * Includes the command signature and brief, but NOT full flags or examples.
Line 680: return `- \`${signature}\` — ${cmd.brief}`;
Line 685: * Each route gets a heading, brief, command list, and a pointer to its reference file.
Line 704: lines.push(route.brief);
> sentry@0.45.0-dev.0 generate:command-docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-command-docs.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-command-docs.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated 36 command doc pages + ../../apps/cli-docs/src/content/docs/commands/index.md + ../../apps/cli-docs/src/content/docs/configuration.md
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: title: agent-conversation 3: description: Agent-conversation commands for the Sentry CLI 4: --- 5: 6: List and view agent conversations 7: 8: ## Commands 9: 10: ### `sentry agent-conversation list [<org>]` 11: 12: List recent agent conversations 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<org>]` | Organization slug | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-n, --limit <limit>` | Number of conversations (1-1000) (default: "25") | 25: | `-q, --query <query>` | Search query | 26: | `-t, --period <period>` | Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" (default: "7d") | 27: | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data | 28: | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" ...
Found 16 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/upgrade.test.ts:
Line 1830: // To keep the ordering deterministic under CI load, the "delayed
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/bench/generate.test.ts:
Line 144: test("is stable regardless of extension ordering", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/sourcemap/resolve.test.ts:
Line 98: // Byte-wise sort, matching resolveDirectorySourcemaps' path ordering.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/security/sentryclirc-url-poison.test.ts:
Line 80: // ordering in cli.ts::preloadProjectContext).
Line 122: // Simulate boot ordering: user sets SENTRY_HOST via env (shell export),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/dsn.test.ts:
Line 4: * Note: Core ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
<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. ...
diff --git a/packages/cli/script/generate-skill.ts b/packages/cli/script/generate-skill.ts
index 512af613b..fb990dd1b 100644
--- a/packages/cli/script/generate-skill.ts
+++ b/packages/cli/script/generate-skill.ts
@@ -1,107 +1,108 @@
#!/usr/bin/env tsx
/**
* Generate Skill Files from Stricli Command Metadata and Docs
*
* Introspects the CLI's route tree and merges with documentation
* to generate structured documentation for AI agents.
*
* Produces:
* - SKILL.md: compact index with agent guidance + command summaries
* - references/*.md: full per-route command documentation
* - index.json: skill discovery manifest for .well-known
*
* Usage:
* tsx script/generate-skill.ts
*
* Output:
* plugins/sentry-cli/skills/sentry-cli/SKILL.md
* plugins/sentry-cli/skills/sentry-cli/references/*.md
* docs/public/.well-known/skills/index.json
*/
import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
import { access, readFile, ...
Found 4 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 107: * `customUsage` is present, its first line is the canonical signature suffix; Line 464: const primaryUsage = docs.customUsage?.[0]; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts: Line 609: customUsage: ["[<org>/]<name>:<platform>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 63: customUsage: [USAGE],
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 ...
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/patches/@stricli%2Fcore@1.2.8.patch
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/patches/@stricli%2Fcore@1.2.8.patch:
Line 202: function buildCommand(builderArgs) {
Line 529: function buildCommand(builderArgs) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/patches/@stricli%2Fcore@1.2.8.patch</path>
<type>file</type>
<content>
190: brief: briefs.helpAll,
191: hidden: !args.config.alwaysShowHelpAllFlag
192: @@ -1920,7 +2004,7 @@ function* generateBuiltInFlagUsageLines(args) {
193: yield args.config.useAliasInUsageLine ? "-h" : "--help";
194: if (args.includeHelpAllFlag) {
195: const helpAllFlagName = formatForDisplay("helpAll", args.config.caseStyle);
196: - yield args.config.useAliasInUsageLine ? "-H" : `--${helpAllFlagName}`;
197: + yield `--${helpAllFlagName}`;
198: }
199: if (args.includeVersionFlag) {
200: yield args.config.useAliasInUsageLine ? "-v" : "--version";
201: @@ -2057,7 +2141,7 @@ function checkForInvalidVariadicSeparators(flags) {
202: function buildCommand(builderArgs) {
203: const { flags = {}, aliases = {} } = builderArgs.parameters;
204: checkForReservedFlags(flags, ["help", "helpAll", "help-all"]);
205: - ...
No files found
<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/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/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 ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation list
3: *
4: * List recent agent conversations from Sentry projects.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { listConversations } from "../../lib/api-client.js";
9: import { validateLimit } from "../../lib/arg-parsing.js";
10: import {
11: advancePaginationState,
12: buildPaginationContextKey,
13: hasPreviousPage,
14: resolveCursor,
15: } from "../../lib/db/pagination.js";
16: import { ContextError } from "../../lib/errors.js";
17: import { formatConversationTable } from "../../lib/formatters/conversation.js";
18: import { filterFields } from "../../lib/formatters/json.js";
19: import { CommandOutput } from "../../lib/formatters/output.js";
20: import { getPositionalString } from "../../lib/introspect.js";
21: import {
22: buildListCommand,
23: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
#!/usr/bin/env tsx
/**
* Validate doc fragment files.
*
* Ensures fragment files stay consistent with the CLI route tree:
* 1. Every route has a corresponding fragment file (+ index.md)
* 2. Every fragment file corresponds to an existing route (or is index.md)
* 3. Fragment files don't accidentally contain frontmatter or the generated marker
* 4. Top-level fragments (e.g., configuration.md) exist
* 5. Fragment content covers all subcommands in a route (warnings only)
*
* Usage:
* tsx script/check-fragments.ts # Warnings for missing subcommands
* tsx script/check-fragments.ts --strict # Errors for missing subcommands
*/
import { mkdirSync, readdirSync } from "node:fs";
import { access, readFile, writeFile } from "node:fs/promises";
import type { RouteInfo, RouteMap } from "../src/lib/introspect.js";
import { DOCS_FRAGMENTS } from "./paths.js";
// Ensure skill-content stub exists (see generate-command-docs.ts for rationale)
const ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,212 +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 { ...
Found 34 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 484: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 130: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts: Line 384: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 575: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/send-envelope.ts: Line 26: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/schema.ts: Line 324: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/view.ts: Line 360: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/react-native/xcode.ts: Line 491: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 204: test("retains structured examples for introspection", () => {
Line 209: examples: [
Line 222: expect((command as unknown as { __examples?: unknown }).__examples).toEqual(
<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: ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED ...
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 ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
Found 5 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/AGENTS.md: Line 432: - `pnpm run check:fragments` validates fragment ↔ route consistency. /home/byk/Code/getsentry/cli-pr-1558/package.json: Line 38: "check:fragments": "pnpm --filter sentry run check:fragments", /home/byk/Code/getsentry/cli-pr-1558/.lore.md: Line 26: * **check-fragments.ts: validates fragment files against actual route names**: \`script/check-fragments.ts\`: validates fragment files against actual route names (Check 1-4) AND validates subcommand coverage within fragments (Check 5). Check 5: for each route with >1 command, verifies fragment mentions each subcommand via a heading (outside fenced code blocks) or \`sentry \<route> \<subcommand>\` code reference. Default commands handled: if fragment contains bare \`sentry \<route>\`, the default command is covered. Default commands detected from route map (\`defaultCommand\` field in route index files). ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
800: };
801:
802: // Iterate the generator using manual .next() instead of for-await-of
803: // so we can capture the return value (done: true result). The return
804: // value carries the final `hint` — for-await-of discards it.
805: //
806: // Auth guard is inside the try block so that maybeRecoverWithHelp can
807: // intercept the AuthError when "help" appears as a positional arg (e.g.
808: // `sentry issue list help`). Without this, the auth prompt would fire
809: // before the help-recovery path could show the command's help text.
810: try {
811: if (requiresAuth && !getAuthConfig()) {
812: throw new AuthError("not_authenticated");
813: }
814:
815: // Validate rc-sourced URL against the active token's host. Deferred
816: // to here (instead of boot) so commands can opt out via skipRcUrlCheck. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
730: ) {
731: applyLoggingFlags(
732: flags[LOG_LEVEL_KEY] as LogLevelName | undefined,
733: flags.verbose as boolean
734: );
735:
736: // Map --org / --project compat flags to env vars before anything
737: // else reads them (auth guard, org/project resolution, etc.)
738: applyOrgProjectFlags(
739: flags.org as string | undefined,
740: flags.project as string | undefined,
741: commandOwnsOrg,
742: commandOwnsProject
743: );
744:
745: const cleanFlags = cleanRawFlags(flags as Record<string, unknown>);
746: setFlagContext(cleanFlags);
747: if (args.length > 0) {
748: setArgsContext(args);
749: }
750:
751: // Environment-based JSON mode (used by library entry point)
752: if (outputConfig && !cleanFlags.json) {
753: const env = (this as unknown as { env?: NodeJS.ProcessEnv ...
## 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 agent-conversation view my-org/conv-123 --json ``` --- generated-current ---
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_08398aef3001gEq0e1Jmy8QGYV
const FRAGMENTS_ROOT = DOCS_FRAGMENTS;
const INDEX_PATH = `${DOCS_DIR}/index.md`;
const CONFIG_PATH = `${DOCS_CONTENT_DIR}/configuration.md`;
/**
* Marker comment separating auto-generated reference content from
* hand-written custom content. Everything above this line is regenerated;
* everything below is preserved.
*/
const GENERATED_END_MARKER = "<!-- GENERATED:END -->";
/**
* Flag names that are auto-injected by the buildCommand wrapper and
* documented in the global footer rather than per-command. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
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 ...
Found 5 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts: Line 186: customUsage: ["<name>:<kind>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 107: * `customUsage` is present, its first line is the canonical signature suffix; Line 464: const primaryUsage = docs.customUsage?.[0]; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts: Line 609: customUsage: ["[<org>/]<name>:<platform>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 63: customUsage: [USAGE],
No files found
packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md
<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 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts: Line 25: fullDescription:
No files found
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -337,127 +337,127 @@ 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 ...
Found 31 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/schema.md: Line 18: | `[<resource...>]` | Resource name and optional operation | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/local.md: Line 33: | `[<command...>]` | Command to run | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/trace.md: Line 39: | `[<org/project/trace-id...>]` | [<org>/<project>/]<trace-id> - Target (optional) and trace ID (required) | Line 58: | `[<org/project/trace-id...>]` | [<org>/[<project>/]]<trace-id> - Optional org/project and required trace ID | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/span.md: Line 18: | `[<org/project/trace-id...>]` | [<org>/<project>] or [<org>/<project>/]<trace-id> | Line 39: | `[<trace-id/span-id...>]` | [<org>/<project>/]<trace-id> ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
<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>
470: // Route Introspection (with async doc loading)
471: // ---------------------------------------------------------------------------
472:
473: /**
474: * Walk the route tree and extract command information with doc examples.
475: * This is the async version that loads documentation examples from disk.
476: */
477: async function extractRoutes(routeMap: RouteMap): Promise<RouteInfo[]> {
478: const result: RouteInfo[] = [];
479: for (const entry of routeMap.getAllEntries()) {
480: if (entry.hidden) {
481: continue;
482: }
483: const routeName = entry.name.original;
484: const target = entry.target;
485: const defaultCommandName = isRouteMap(target)
486: ? ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/time-range.ts:
Line 63: * they only change ~12×/year instead of daily. Keeps examples looking current
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 112: /** Canonical examples consumed by generated documentation. */
Line 113: readonly examples?: readonly CommandExample[];
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 444: const { examples, ...nativeDocs } = docs;
Line 445: if (!examples?.length) {
Line 449: const renderedExamples = examples
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
Line 469: if (docs.examples?.length) {
Line 470: metadata.__examples = ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
670: ): string {
671: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
672: let syntax = `--${flag.name}`;
673: if (alias) {
674: syntax = `-${alias}, ${syntax}`;
675: }
676: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
677: syntax += " <value>";
678: } else if (flag.variadic) {
679: syntax += " <value>...";
680: }
681: const parts = [syntax];
682: if (flag.brief) {
683: parts.push(flag.brief);
684: }
685: if (flag.default !== undefined && flag.kind !== "boolean") {
686: parts.push(`(default: ${JSON.stringify(flag.default)})`);
687: }
688: return parts.join(" — ");
689: }
690:
691: /**
692: * Format a CommandInfo as human-readable text.
693: */
694: function formatCommandHuman(cmd: CommandInfo): string {
695: const lines: string[] = [];
696: const signature = ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
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 = ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help agent-conversation list --json
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
590: }
591:
592: const { project, dsn, url } = projectDetails;
593: return {
594: project,
595: orgSlug,
596: teamSlug,
597: teamSource,
598: requestedPlatform: platform,
599: dsn,
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. ...
bbaa7b3b722b87f1bccfe84063269cbbcabe2741
bbaa7b3b7 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)
{"baseRefName":"main","body":"The agent-conversation reference currently shows `sentry agent-conversation view my-org conv-123`, but `view` accepts one `[<org>/]<conversation-id>` positional argument. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/package.json: Line 69: "generate:skill": "pnpm tsx script/generate-skill.ts", Line 71: "generate:docs": "pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections", Line 74: "generate:command-docs": "pnpm tsx script/generate-command-docs.ts",
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
<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: ...
<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/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
> sentry@0.45.0-dev.0 generate:command-docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-command-docs.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-command-docs.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated 36 command doc pages + ../../apps/cli-docs/src/content/docs/commands/index.md + ../../apps/cli-docs/src/content/docs/configuration.md > sentry@0.45.0-dev.0 generate:skill /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-skill.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-skill.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated ...
<path>/home/byk/Code/getsentry/cli-pr-1558/.lore.md</path>
<type>file</type>
<content>
1: <!-- Managed by lore (https://github.com/BYK/loreai) — manual edits are imported on next session. -->
2:
3: ## Long-term Knowledge
4:
5: ### Architecture
6:
7: <!-- lore:01a02357-f0a8-7fdb-9e9d-b0710cfe65c9 -->
8: * **API output binary and HTTP contracts**: Always preserve strict output-mode and binary-safety contracts. `sentry api` must preserve `rawApiRequest()` status text; empty textual non-2xx bodies must produce an HTTP status/request fallback, and JSON mode must expose `{status, statusText, body}` so empty success and error responses are distinguishable. Binary `Uint8Array` successes bypass formatters and remain raw; binary errors emit only status/content-type/byte-count summaries, never bytes or JSON coercion. Prompts must never block scripted runs or interleave with stdout JSON.
9:
10: <!-- lore:019ef480-47f1-7708-80cb-514ac37a3fde -->
11: * **@sentry/symbolic 13.4.0 API surface: ...
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 @@ -1,222 +1,234 @@ /** * Command builder with telemetry, global flag injection, and output modes. * * Provides `buildCommand` — the standard command builder for all Sentry CLI * commands. It wraps Stricli's `buildCommand` with: * * 1. **Automatic flag/arg telemetry** — captures flag values and positional * arguments as Sentry span context for observability. * * 2. **Hidden global logging flags** — injects `--log-level` and `--verbose` * into every command's parameters. These are intercepted before the original * `func` runs: the logger level is set, and the injected flags are stripped * so the original function never sees them. If a command already defines its * own `--verbose` flag (e.g. ...
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.");
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation view --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation view [<org>/]<conversation-id> sentry agent-conversation view --help View the full transcript of an agent conversation. The org is optional and auto-detected from your project context when omitted. Prefix the ID with an org slug to target a specific org. ...
Found 2 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 63: customUsage: [USAGE],
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
@@ -106,208 +106,211 @@ for (const file of fragmentFiles) {
}
}
// ---------------------------------------------------------------------------
// Check 4: Top-level fragments (non-command generated pages)
// ---------------------------------------------------------------------------
const TOP_LEVEL_FRAGMENTS_DIR = DOCS_FRAGMENTS;
/** Top-level fragment files that must exist (for generated doc pages) */
const REQUIRED_TOP_LEVEL_FRAGMENTS = ["configuration"];
for (const name of REQUIRED_TOP_LEVEL_FRAGMENTS) {
const path = `${TOP_LEVEL_FRAGMENTS_DIR}/${name}.md`;
const exists = await access(path).then(
() => true,
() => false
);
if (!exists) {
errors.push(
`Missing top-level fragment: ${path} (required for generated ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
130: const ctx = createTestContext();
131: const cases: Array<{
132: args: string[];
133: expected: boolean;
134: }> = [
135: { args: ["init", "-y"], expected: false },
136: { args: ["init", "-n"], expected: false },
137: { args: ["init", "--yes=false"], expected: true },
138: { args: ["data", "-n", "10"], expected: true },
139: { args: ["data", "-y", "2"], expected: true },
140: ];
141:
142: try {
143: for (const testCase of cases) {
144: await run(app, testCase.args, ctx as TestContext);
145: expect(promptStates.at(-1)).toBe(testCase.expected);
146: }
147: } finally {
148: setInteractivePromptsAllowed(true);
149: }
150: });
151:
152: describe("buildCommand", () => {
153: test("builds a valid command object", () => {
154: const command = buildCommand({
155: auth: false,
156: docs: { ...
No files found
<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>
## 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 agent-conversation view my-org/conv-123 --json ```
Found 20 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/index.ts:
Line 2: * sentry agent-conversation
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts:
Line 2: * sentry agent-conversation view
Line 31: const USAGE_HINT = `sentry agent-conversation view ${USAGE}`;
Line 68: examples: [
Line 71: command: "sentry agent-conversation view conv-123",
Line 75: command: "sentry agent-conversation view my-org/conv-123",
Line 79: command: "sentry agent-conversation view my-org/conv-123 --json",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts:
Line 2: * sentry agent-conversation list
Line 61: const COMMAND_NAME = "agent-conversation list";
Line 62: const PAGINATION_KEY = "agent-conversation-list";
Line 111: export const listCommand = buildListCommand("agent-conversation", {
Line 117: examples: [
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
95: const items =
96: fields && fields.length > 0
97: ? result.conversations.map((c) => filterFields(c, fields))
98: : result.conversations;
99:
100: const envelope: Record<string, unknown> = {
101: data: items,
102: hasMore: result.hasMore,
103: hasPrev: !!result.hasPrev,
104: };
105: if (result.nextCursor) {
106: envelope.nextCursor = result.nextCursor;
107: }
108: return envelope;
109: }
110:
111: export const listCommand = buildListCommand("agent-conversation", {
112: docs: {
113: brief: "List recent agent conversations",
114: fullDescription:
115: "List recent agent conversations from a Sentry organization.\n\n" +
116: "The organization is auto-detected when omitted.",
117: examples: [
118: {
119: description: "List recent agent conversations",
120: command: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
45: readonly query?: string;
46: readonly period: TimeRange;
47: readonly json: boolean;
48: readonly cursor?: string;
49: readonly fresh: boolean;
50: readonly fields?: string[];
51: };
52:
53: type ConversationListResult = {
54: conversations: ConversationListItem[];
55: hasMore: boolean;
56: hasPrev?: boolean;
57: nextCursor?: string;
58: org: string;
59: };
60:
61: const COMMAND_NAME = "agent-conversation list";
62: const PAGINATION_KEY = "agent-conversation-list";
63: const DEFAULT_PERIOD = "7d";
64: const POSITIONAL = {
65: kind: "tuple",
66: parameters: [
67: {
68: placeholder: "org",
69: brief: "Organization slug",
70: parse: String,
71: optional: true,
72: },
73: ],
74: } as const;
75: const USAGE_HINT = `sentry ${COMMAND_NAME} ${getPositionalString(POSITIONAL)}`;
76:
77: function ...
No files found
No files found
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
Checked 15 files in 2s. No fixes applied.
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
Found 12 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 98: expect(getPositionalString(undefined)).toBe("");
Line 102: const result = getPositionalString({
Line 110: const result = getPositionalString({
Line 121: const result = getPositionalString({
Line 129: const result = getPositionalString({
Line 137: const result = getPositionalString({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts:
Line 150: const result = getPositionalString({
Line 174: const result = getPositionalString({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 195: export function getPositionalString(params?: PositionalParams): string {
Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts:
Line 75: const ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
90: /**
91: * Generate the commands list dynamically from Stricli's route structure.
92: * This ensures help text stays in sync with actual registered commands.
93: */
94: function generateCommands(): HelpCommand[] {
95: // Cast to our introspection types — Stricli's generic types are compatible
96: const routeMap = routes as unknown as RouteMap;
97: const entries = routeMap.getAllEntries();
98:
99: return entries
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible subcommand names and join with pipes
107: const subEntries = entry.target
108: .getAllEntries()
109: .filter((sub: RouteMapEntry) => !sub.hidden);
110: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts</path>
<type>file</type>
<content>
120:
121: test("boolean flags default to optional=true", () => {
122: fcAssert(
123: property(flagsMapArb, (flags) => {
124: const result = extractFlags(flags);
125: for (const flag of result) {
126: if (
127: flag.kind === "boolean" &&
128: flags[flag.name].optional === undefined
129: ) {
130: expect(flag.optional).toBe(true);
131: }
132: }
133: }),
134: { numRuns: DEFAULT_NUM_RUNS }
135: );
136: });
137: });
138:
139: describe("property: getPositionalString", () => {
140: test("tuple always produces angle-bracket placeholders", () => {
141: fcAssert(
142: property(
143: array(
144: record({
145: placeholder: oneof(string(), constantFrom(undefined)),
146: optional: boolean(),
147: ...
Found 10 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts:
Line 32: import { DEFAULT_NUM_RUNS } from "../model-based/helpers.js";
Line 104: { numRuns: DEFAULT_NUM_RUNS }
Line 117: { numRuns: DEFAULT_NUM_RUNS }
Line 134: { numRuns: DEFAULT_NUM_RUNS }
Line 167: { numRuns: DEFAULT_NUM_RUNS }
Line 180: { numRuns: DEFAULT_NUM_RUNS }
Line 204: { numRuns: DEFAULT_NUM_RUNS }
Line 217: { numRuns: DEFAULT_NUM_RUNS }
Line 228: { numRuns: DEFAULT_NUM_RUNS }
Line 240: { numRuns: DEFAULT_NUM_RUNS }
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/model-based/helpers.ts</path>
<type>file</type>
<content>
1: /**
2: * Model-Based Testing Helpers
3: *
4: * Shared utilities for fast-check model-based tests.
5: */
6:
7: import { mkdirSync } from "node:fs";
8: import { join } from "node:path";
9: import { CONFIG_DIR_ENV_VAR, closeDatabase } from "../../src/lib/db/index.js";
10:
11: /**
12: * Create an isolated database context for model-based tests.
13: * Each test run gets its own SQLite database to avoid interference.
14: *
15: * @returns Cleanup function to call after test completes
16: */
17: export function createIsolatedDbContext(): () => void {
18: const testBaseDir = process.env[CONFIG_DIR_ENV_VAR];
19: if (!testBaseDir) {
20: throw new Error(`${CONFIG_DIR_ENV_VAR} not set - run tests via bun test`);
21: }
22:
23: // Close any existing database connection
24: closeDatabase();
25:
26: // Create unique subdirectory for this test run
27: ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework DEPRECATED ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,212 +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 { ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts: Line 122: entry.target.__primaryUsage ??
No files found
Found 31 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 55: * reads it to populate {@link CommandInfo.jsonFields}.
Line 102: export type CommandInfo = {
Line 113: jsonFields?: SchemaFieldInfo[];
Line 131: commands: CommandInfo[];
Line 139: | { kind: "command"; info: CommandInfo }
Line 280: * Build a {@link CommandInfo} from a Stricli Command.
Line 286: export function buildCommandInfo(
Line 290: ): CommandInfo {
Line 291: const jsonFields = cmd.__jsonSchema
Line 309: jsonFields: jsonFields?.length ? jsonFields : undefined,
Line 324: ): CommandInfo[] {
Line 325: const commands: CommandInfo[] = [];
Line 336: commands.push(buildCommandInfo(subTarget, path, examples));
Line 356: export function extractAllRoutes(routeMap: RouteMap): RouteInfo[] {
Line 378: commands: [buildCommandInfo(target, path)],
Line 453: info: buildCommandInfo(target, `sentry ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
680: }
681: const parts = [syntax];
682: if (flag.brief) {
683: parts.push(flag.brief);
684: }
685: if (flag.default !== undefined && flag.kind !== "boolean") {
686: parts.push(`(default: ${JSON.stringify(flag.default)})`);
687: }
688: return parts.join(" — ");
689: }
690:
691: /**
692: * Format a CommandInfo as human-readable text.
693: */
694: function formatCommandHuman(cmd: CommandInfo): string {
695: const lines: string[] = [];
696: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
697: lines.push(signature);
698: lines.push("");
699: lines.push(` ${cmd.brief}`);
700:
701: const visibleFlags = cmd.flags.filter((f) => !f.hidden);
702: if (visibleFlags.length > 0) {
703: lines.push("");
704: lines.push(" Flags:");
705: for (const flag of visibleFlags) {
706: lines.push(` ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
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,203 +1,207 @@
/**
* 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 31 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/schema.md: Line 18: | `[<resource...>]` | Resource name and optional operation | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/local.md: Line 33: | `[<command...>]` | Command to run | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/trace.md: Line 39: | `[<org/project/trace-id...>]` | [<org>/<project>/]<trace-id> - Target (optional) and trace ID (required) | Line 58: | `[<org/project/trace-id...>]` | [<org>/[<project>/]]<trace-id> - Optional org/project and required trace ID | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/span.md: Line 18: | `[<org/project/trace-id...>]` | [<org>/<project>] or [<org>/<project>/]<trace-id> | Line 39: | `[<trace-id/span-id...>]` | [<org>/<project>/]<trace-id> ...
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 ...
<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/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/introspect.ts</path>
<type>file</type>
<content>
185: // ---------------------------------------------------------------------------
186: // Extraction Functions
187: // ---------------------------------------------------------------------------
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: ...
Found 12 matches
/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
/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,
<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>
390: * @param builderArgs - Same shape as Stricli's buildCommand arguments,
391: * plus an optional `output` mode
392: * @returns A fully-wrapped Stricli Command
393: */
394:
395: /**
396: * Build the `--fields` flag definition, enriched with available field names
397: * when a schema is registered on the output config.
398: */
399: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
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}. ...
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.");
<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/src/lib/command.ts</path>
<type>file</type>
<content>
840:
841: // Render phase: output finalization.
842: // Append cache-age hint automatically so every command gets
843: // "cached · 3m ago · use -f to refresh" when data was cached.
844: // Skip bare `return;` paths (e.g. `--web` which opens a browser
845: // without yielding) — no rendered output should mean no footer.
846: const finalHint = returned ? appendCacheHint(returned.hint) : undefined;
847: await withTracing("render", "cli.command.render", () => {
848: writeFinalization(stdout, finalHint, cleanFlags.json, renderer);
849: });
850: } catch (err) {
851: // Finalize before error handling to close streaming state
852: // (e.g., table footer). No hint since the generator didn't
853: // complete. Only in human mode — JSON must not be corrupted.
854: if (!cleanFlags.json) {
855: ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_083b817be001p7lzYN3glIY4Ig
// Arguments table
if (cmd.positionals.length > 0) {
lines.push("");
lines.push(formatPositionalsTable(cmd.positionals));
}
// Options table
const visibleFlags = getVisibleFlags(cmd);
if (visibleFlags.length > 0) {
lines.push("");
lines.push(formatFlagsTable(visibleFlags, cmd.aliases));
}
+ const examples = formatCommandExamples(cmd.examples);
+ if (examples) {
+ lines.push("", examples);
+ }
+
return lines.join("\n");
}
/** Determine if a route is a standalone command (not a group with subcommands) */
function isStandaloneCommand(route: RouteInfo): boolean {
return (
route.commands.length === 1 &&
route.commands[0].path === `sentry ${route.name}`
);
}
/**
* Generate the full auto-generated portion of a command doc page. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts</path>
<type>file</type>
<content>
131: // ---------------------------------------------------------------------------
132: // Check 5: Subcommand coverage in fragment content
133: // ---------------------------------------------------------------------------
134:
135: const warnings: string[] = [];
136:
137: const FENCED_CODE_BLOCK_RE = /^(`{3,}|~{3,}).*\n[\s\S]*?\n\1\s*$/gm;
138:
139: /** Strip fenced code blocks from markdown to avoid matching bash comments as headings. */
140: function stripCodeBlocks(md: string): string {
141: return md.replace(FENCED_CODE_BLOCK_RE, "");
142: }
143:
144: /**
145: * Check whether a fragment mentions a specific subcommand.
146: *
147: * Looks for either:
148: * 1. A full CLI reference: `sentry <route> <subcommand>` anywhere in the text
149: * 2. ...
<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/introspect.ts</path>
<type>file</type>
<content>
279: /**
280: * Build a {@link CommandInfo} from a Stricli Command.
281: *
282: * @param cmd - The Stricli command to introspect
283: * @param path - Full command path (e.g. "sentry issue list")
284: * @param examples - Optional usage examples
285: */
286: export function buildCommandInfo(
287: cmd: Command,
288: path: string,
289: examples: string[] = []
290: ): CommandInfo {
291: const jsonFields = cmd.__jsonSchema
292: ? extractSchemaFields(cmd.__jsonSchema)
293: : undefined;
294:
295: return {
296: path,
297: brief: cmd.brief,
298: fullDescription: cmd.fullDescription,
299: flags: extractFlags(cmd.parameters.flags),
300: positional:
301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
302: positionals: extractPositionals(cmd.parameters.positional),
303: aliases: cmd.parameters.aliases ?? ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
459: // More path segments — must be a route map to navigate deeper
460: if (!isRouteMap(target)) {
461: return null;
462: }
463:
464: // Recurse into the sub-route map with remaining path segments
465: const subResult = resolveCommandPath(target, rest);
466: if (!subResult) {
467: return null;
468: }
469:
470: // Prepend the parent route segment to all paths in the result
471: const parentPrefix = entry.name.original;
472: const prependPrefix = (p: string) =>
473: p.replace(SENTRY_PREFIX_RE, `sentry ${parentPrefix} `);
474:
475: if (subResult.kind === "command") {
476: return {
477: kind: "command",
478: info: { ...subResult.info, path: prependPrefix(subResult.info.path) },
479: };
480: }
481: if (subResult.kind === "group") {
482: return {
483: kind: "group",
484: info: {
485: ...
<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: ...
No files found
Found 20 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-json.test.ts:
Line 90: // `sentry issue nope --help --json`: the scanner forwards `nope` to the
Line 106: // `sentry --org acme issue list --help --json`: `--org acme` is forwarded
Line 120: test("returns undefined when not a --help --json request", () => {
Line 130: test("rewrites an unknown-command --help --json to the help command", () => {
Line 158: // `sentry --org acme --log-level debug cli nope --help --json`: the values
Line 233: test("true for a --help --json request whose last token is --json", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/help.test.ts:
Line 4: * Tests `sentry help --json` output for full tree, specific groups,
Line 43: describe("sentry help --json", () => {
Line 92: describe("sentry help --json <group>", () => {
Line 114: describe("sentry help --json <group> <command>", () => {
Line 146: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/help.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Tests for the Help Command
3: *
4: * Tests `sentry help --json` output for full tree, specific groups,
5: * specific commands, and not-found cases.
6: */
7:
8: import { run } from "@stricli/core";
9: import { describe, expect, test } from "vitest";
10: import { app } from "../../src/app.js";
11: import type { SentryContext } from "../../src/context.js";
12:
13: /**
14: * Run a help command and capture stdout output.
15: */
16: async function runHelp(args: string[]): Promise<string> {
17: let output = "";
18: const mockContext: SentryContext = {
19: process,
20: env: process.env,
21: cwd: process.cwd(),
22: homeDir: "/tmp",
23: configDir: "/tmp",
24: stdout: {
25: write(data: string | Uint8Array) {
26: output +=
27: typeof data === "string" ? data : new TextDecoder().decode(data);
28: ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help --json agent-conversation list
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, ...
Found 2 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 63: customUsage: [USAGE],
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/log/list.ts: Line 750: optional: true, Line 756: optional: true, Line 763: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/list.ts: Line 284: optional: true, Line 299: optional: true, Line 306: optional: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
98: * Native Stricli documentation. When `customUsage` is present, its first line
408:function enrichDocsWithSchema(
517: const enrichedDocs = enrichDocsWithSchema(builderArgs.docs, outputConfig);
841: // Stricli uses customUsage for native help but does not expose it on the
843: const primaryUsage = enrichedDocs.customUsage?.[0];
845: (cmd as unknown as Record<string, unknown>).__primaryUsage =
61: __primaryUsage?: string;
69:/** A single positional parameter with optional brief and placeholder */
73: optional?: boolean;
80: optional: boolean;
88: optional?: boolean;
119: optional: boolean;
192:export function getPositionalString(params?: PositionalParams): string {
215: * the parameter is optional. Used by documentation generators to build
232: optional: p.optional ?? false,
241: optional: true,
267: optional: def.optional ?? def.kind === "boolean",
295: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 2 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/agent-conversation.md
Not documented: list, view
Hint: add a heading or code example for each (e.g., "sentry agent-conversation list")
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
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 ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_083bee115001YeoRRZ2chPDA7A
- },
+ positional: POSITIONAL,
flags: {
limit: {
kind: "parsed",
parse: parseLimit,
brief: `Number of conversations (${LIST_MIN_LIMIT}-${LIST_MAX_LIMIT})`,
default: String(LIST_DEFAULT_LIMIT),
},
query: {
kind: "parsed",
parse: String,
brief: "Search query",
optional: true,
},
period: LIST_PERIOD_FLAG,
},
aliases: {
...PERIOD_ALIASES,
n: "limit",
q: "query",
},
},
async *func(this: SentryContext, flags: ListFlags, target?: string) {
const { cwd } = this;
const resolved = await resolveOrg({ org: target, cwd });
if (!resolved) {
- throw new ContextError("Organization", `sentry ${COMMAND_NAME} <org>`);
+ throw new ContextError("Organization", USAGE_HINT);
}
const org = ...
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 ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/release/deploy.ts</path>
<type>file</type>
<content>
85: export const deployCommand = buildCommand({
86: docs: {
87: brief: "Create a deploy for a release",
88: fullDescription:
89: "Create a deploy record for a release in a specific environment.\n\n" +
90: "Examples:\n" +
91: " sentry release deploy 1.0.0 production\n" +
92: ' sentry release deploy my-org/1.0.0 staging "Deploy #42"\n' +
93: " sentry release deploy 1.0.0 production --url https://example.com\n" +
94: " sentry release deploy 1.0.0 production --time 120\n" +
95: " sentry release deploy 1.0.0 production --dry-run",
96: },
97: output: {
98: human: formatDeployCreated,
99: },
100: parameters: {
101: positional: {
102: kind: "tuple",
103: parameters: [
104: {
105: placeholder: "org/version",
106: brief: "[<org>/]<version> - Release version",
107: ...
<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: ...
No files found
No files found
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.cts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.cjs
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 1411: interface CommandDocumentation {
Line 1423: readonly customUsage?: readonly (string | CustomUsage)[];
Line 1434: readonly docs: CommandDocumentation;
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path> <type>file</type> <content> 1380: 1381: /** 1382: * Parses input strings as booleans. 1383: * Transforms to lowercase and then checks against "true" and "false". 1384: */ 1385: declare const booleanParser: (input: string) => boolean; 1386: /** 1387: * Parses input strings as booleans (loosely). 1388: * Transforms to lowercase and then checks against the following values: 1389: * - `true`: `"true"`, `"t"`, `"yes"`, `"y"`, `"on"`, `"1"`, `""` 1390: * - `false`: `"false"`, `"f"`, `"no"`, `"n"`, `"off"`, `"0"` 1391: * 1392: * Parsers are only executed when an input is provided, 1393: * so the empty string is treated as a truthy value (i.e. a flag that is present but has no value is treated as `true`). ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
Found 10 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 33: * Simple interface that mirrors NodeJS.Process but only requires the minimum API required by Stricli.
Line 998: interface BasePositionalParameter<T, CONTEXT extends CommandContext> extends ParsedParameter<T, CONTEXT> {
Line 1014: interface RequiredPositionalParameter<T, CONTEXT extends CommandContext> extends BasePositionalParameter<T, CONTEXT> {
Line 1020: interface OptionalPositionalParameter<T, CONTEXT extends CommandContext> extends BasePositionalParameter<T, CONTEXT> {
Line 1031: type PositionalParameter = BasePositionalParameter<unknown, CommandContext>;
Line 1033: readonly kind: "array";
Line 1035: readonly minimum?: number;
Line 1298: * If specified, indicates the minimum number of arguments that are expected and the last argument count.
Line 1300: readonly limit?: [minimum: number, count: number];
Line 1301: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path> <type>file</type> <content> 980: readonly positional: TypedPositionalParameters<ARGS, CONTEXT>; 981: } 982: type TypedCommandPositionalParameters<ARGS extends BaseArgs, CONTEXT extends CommandContext> = [] extends ARGS ? Partial<TypedCommandPositionalParameters_<ARGS, CONTEXT>> : TypedCommandPositionalParameters_<ARGS, CONTEXT>; 983: /** 984: * Definitions for all parameters requested by the corresponding command. 985: */ 986: type TypedCommandParameters<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = TypedCommandFlagParameters<FLAGS, CONTEXT> & TypedCommandPositionalParameters<ARGS, CONTEXT>; 987: /** 988: * Definitions for all parameters requested by the corresponding command. ...
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 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 ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Test Files 1 passed (1)
Tests 20 passed (20)
Start at 01:24:15
Duration 7.51s (transform 5.14s, setup 76ms, import 7.16s, tests 66ms, environment 0ms)
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Test Files 1 passed (1)
Tests 9 passed (9)
Start at 01:24:40
Duration 3.88s (transform 2.51s, setup 128ms, import 3.45s, tests 97ms, environment 0ms)
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Test Files 1 passed (1)
Tests 9 passed (9)
Start at 01:24:45
Duration 3.99s (transform 2.67s, setup 92ms, import 3.62s, tests 89ms, environment 0ms)
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
DEPRECATED `test.poolOptions` was removed in Vitest 4. ...
Found 34 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 484: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 130: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/merge.ts: Line 276: kind: "array", /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/span/view.ts: Line 384: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 575: 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/send-envelope.ts: ...
No files found
<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/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 ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
180: }
181:
182: /** Extract all code blocks from markdown */
183: function extractCodeBlocks(
184: markdown: string,
185: language?: string
186: ): { code: string; lang: string }[] {
187: const blocks: { code: string; lang: string }[] = [];
188: const pattern = new RegExp(CODE_BLOCK_REGEX.source, CODE_BLOCK_REGEX.flags);
189: let match = pattern.exec(markdown);
190: while (match !== null) {
191: const lang = match[1] || "";
192: const code = match[2].trim();
193: if (!language || lang === language) {
194: blocks.push({ code, lang });
195: }
196: match = pattern.exec(markdown);
197: }
198: return blocks;
199: }
200:
201: /** Escape special regex characters in a string */
202: function escapeRegex(str: string): string {
203: return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
204: }
205:
206: // ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2005: if (customUsage) {
Line 2006: for (const usage of customUsage) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1985: if (def.default) {
1986: const defaultKeyword = args.ansiColor ? `\x1B[2m${keywords.default}\x1B[22m` : keywords.default;
1987: suffix = `[${defaultKeyword} ${def.default}]`;
1988: }
1989: return [
1990: args.ansiColor ? `\x1B[1m${name}\x1B[22m` : name,
1991: args.ansiColor ? `\x1B[3m${def.brief}\x1B[23m` : def.brief,
1992: suffix ?? ""
1993: ];
1994: }),
1995: [" ", " "]
1996: );
1997: }
1998:
1999: // src/routing/command/documentation.ts
2000: function* generateCommandHelpLines(parameters, docs, args) {
2001: const { brief, fullDescription, customUsage } = docs;
2002: const { headers } = args.text;
2003: const prefix = args.prefix.join(" ");
2004: yield args.ansiColor ? `\x1B[4m${headers.usage}\x1B[24m` : headers.usage;
2005: if (customUsage) {
2006: for ...
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 440: * If specified, indicates the minimum number of arguments that are expected and the last argument count.
Line 820: if (positional.kind === "array") {
Line 821: if (typeof positional.minimum === "number" && positionalIndex < positional.minimum) {
Line 824: positional.minimum,
Line 993: if (positional.kind === "array") {
Line 1838: if (positional.kind === "array") {
Line 1968: if (positional.kind === "array") {
Line 2037: if (positional.kind === "array" || positional.parameters.length > 0) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1950: ];
1951: }),
1952: [" ", " ", " "]
1953: );
1954: }
1955: function* generateBuiltInFlagUsageLines(args) {
1956: yield args.config.useAliasInUsageLine ? "-h" : "--help";
1957: if (args.includeHelpAllFlag) {
1958: const helpAllFlagName = formatForDisplay("helpAll", args.config.caseStyle);
1959: yield `--${helpAllFlagName}`;
1960: }
1961: if (args.includeVersionFlag) {
1962: yield args.config.useAliasInUsageLine ? "-v" : "--version";
1963: }
1964: }
1965:
1966: // src/parameter/positional/formatting.ts
1967: function formatDocumentationForPositionalParameters(positional, args) {
1968: if (positional.kind === "array") {
1969: const name = positional.parameter.placeholder ?? "args";
1970: const argName = args.ansiColor ? `\x1B[1m${name}...\x1B[22m` : `${name}...`;
1971: const brief = args.ansiColor ? ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1810: const aliases = Object.entries(parameters.aliases).filter((entry) => entry[1] === name);
1811: if (aliases.length === 1 && aliases[0]) {
1812: displayName = `-${aliases[0][0]}`;
1813: }
1814: }
1815: if (flag.kind === "boolean") {
1816: return [flag, displayName];
1817: }
1818: if (flag.kind === "enum" && typeof flag.placeholder !== "string") {
1819: return [flag, `${displayName} ${flag.values.join("|")}`];
1820: }
1821: const placeholder = flag.placeholder ?? "value";
1822: return [flag, `${displayName} ${placeholder}`];
1823: }).map(([flag, usage]) => {
1824: if (flag.kind === "parsed" && flag.variadic) {
1825: if (isOptionalAtRuntime(flag)) {
1826: return wrapVariadicFlag(wrapOptionalFlag(usage));
1827: }
1828: return ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
595: orgSlug,
596: teamSlug,
597: teamSource,
598: requestedPlatform: platform,
599: dsn,
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. Create several projects at once\n" +
616: "by passing multiple pairs as separate arguments. All projects share one ...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/defaults.ts</path>
<type>file</type>
<content>
292: "|-----|------------|\n" +
293: "| `org` | Default organization slug |\n" +
294: "| `project` | Default project slug |\n" +
295: "| `telemetry` | Telemetry preference (on/off, yes/no, true/false, 1/0) |\n" +
296: "| `agent-skills` | Install agent skills on setup/upgrade (on/off, yes/no, true/false, 1/0) |\n" +
297: "| `graphics` | Render images inline on capable terminals (on/off, yes/no, true/false, 1/0) |\n" +
298: "| `url` | Sentry instance URL (for self-hosted installations) |\n" +
299: "| `headers` | Custom HTTP headers for self-hosted proxies (semicolon-separated `Name: Value`) |\n" +
300: "| `ca-cert` | Path to PEM file with custom CA certificates (for corporate proxies) |",
301: },
302: output: {
303: human: formatDefaultsResult,
304: jsonExclude: ["telemetryEffective"],
305: },
306: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts</path>
<type>file</type>
<content>
95: // ---------------------------------------------------------------------------
96:
97: describe("property: extractFlags", () => {
98: test("always returns one FlagInfo per input entry", () => {
99: fcAssert(
100: property(flagsMapArb, (flags) => {
101: const result = extractFlags(flags);
102: expect(result).toHaveLength(Object.keys(flags).length);
103: }),
104: { numRuns: DEFAULT_NUM_RUNS }
105: );
106: });
107:
108: test("preserves flag names", () => {
109: fcAssert(
110: property(flagsMapArb, (flags) => {
111: const result = extractFlags(flags);
112: const resultNames = new Set(result.map((f) => f.name));
113: for (const name of Object.keys(flags)) {
114: expect(resultNames.has(name)).toBe(true);
115: }
116: }),
117: { numRuns: ...
Found 9 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 111: examples: string[]; Line 289: examples: string[] = [] Line 304: examples: cmd.__examples?.length /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/local.ts: Line 270: * Output examples: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts: Line 520: examples: string[], Line 542: examples: string[], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/widget/index.ts: Line 47: "Row-filling examples:\n" + /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
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
@@ -246,40 +246,43 @@ function getDefaultCommandName(routeName: string): string | undefined {
}
return;
}
const multiCommandRoutes = getMultiCommandRoutes();
for (const [routeName, route] of multiCommandRoutes) {
const fragmentPath = `${FRAGMENTS_DIR}/${routeName}.md`;
let content: string;
try {
content = await readFile(fragmentPath, "utf-8");
} catch {
// Fragment doesn't exist — already caught by Check 1
continue;
}
const defaultCmd = getDefaultCommandName(routeName);
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? ...
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/snapshots/diff.ts: Line 271: default: "0.01", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/list.ts: Line 313: default: "date", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/release/set-commits.ts: Line 429: default: "20", // Stricli passes string defaults through parse(); numberParser converts to number /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/explore.ts: ...
<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>
800: };
801:
802: // Iterate the generator using manual .next() instead of for-await-of
803: // so we can capture the return value (done: true result). The return
804: // value carries the final `hint` — for-await-of discards it.
805: //
806: // Auth guard is inside the try block so that maybeRecoverWithHelp can
807: // intercept the AuthError when "help" appears as a positional arg (e.g.
808: // `sentry issue list help`). Without this, the auth prompt would fire
809: // before the help-recovery path could show the command's help text.
810: try {
811: if (requiresAuth && !getAuthConfig()) {
812: throw new AuthError("not_authenticated");
813: }
814:
815: // Validate rc-sourced URL against the active token's host. Deferred
816: // to here (instead of boot) so commands can opt out via skipRcUrlCheck. ...
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 459: function attachDocumentationMetadata( Line 563: const stricliDocs = enrichDocsWithSchema( Line 885: docs: stricliDocs,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
380: * is skipped. The command's own `verbose` value is still used for log-level
381: * side-effects, and it is **not** stripped — the original func receives it as usual.
382: *
383: * Similarly, when a command already defines its own `json` flag (e.g. for
384: * custom brief text), the injected `JSON_FLAG` is skipped. `--fields` is
385: * always injected when `output: { human: ... }` regardless.
386: *
387: * Flag keys use kebab-case because Stricli uses the literal object key as
388: * the CLI flag name (e.g. `"log-level"` → `--log-level`). ...
<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 7 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts:
Line 146: /** Format positional arguments as a markdown table */
Line 147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
Line 148: if (positionals.length === 0) {
Line 157: for (const p of positionals) {
Line 194: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
Line 200: if (cmd.positionals.length > 0) {
Line 202: lines.push(formatPositionalsTable(cmd.positionals));
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_083cd106a001Yd3jC6Q0B4o5XC
return s.toUpperCase();
}
return s.charAt(0).toUpperCase() + s.slice(1);
}
// ---------------------------------------------------------------------------
// Index Table Generation
// ---------------------------------------------------------------------------
/**
* Generate the commands table for index.md.
* Uses the route order from extractAllRoutes() (which preserves the
* insertion order from app.ts's buildRouteMap) — no manual constant needed.
*/
function generateCommandsTable(allRoutes: RouteInfo[]): string {
const lines: string[] = [];
lines.push("| Command | Description |");
lines.push("|---------|-------------|");
for (const route of allRoutes) {
lines.push(`| [\`${route.name}\`](./${route.name}/) | ${route.brief} |`);
}
return lines.join("\n");
}
// ...
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands</path> <type>directory</type> <entries> agent-conversation.md alert.md api.md auth.md build.md cli.md code-mappings.md dart-symbol-map.md dashboard.md debug-files.md docs.md event.md explore.md feedback.md index.md info.md init.md issue.md local.md log.md monitor.md org.md platform.md proguard.md project.md react-native.md release.md replay.md repo.md schema.md snapshots.md sourcemap.md span.md status.md team.md trace.md trial.md (37 entries) </entries>
<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/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 ...
{"baseRefName":"main","body":"The agent-conversation reference currently shows `sentry agent-conversation view my-org conv-123`, but `view` accepts one `[<org>/]<conversation-id>` positional argument. The list and view headings also make the organization appear mandatory even though both support detection.\n\nCorrect the authoritative examples to use `my-org/conv-123`, include the detected-organization form, and add command-specific usage metadata. Regenerate the skill index/reference with the existing generator. Command execution and argument parsing are unchanged.\n\nValidation:\n\n- Both new documentation regressions fail against current main before the correction.\n- Generated API schema, SDK, command docs and skills through the existing scripts.\n- 101 focused command, API, formatter and documentation tests passed across five files.\n- Biome checked the three TypeScript files with no fixes or ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 1795: function wrapVariadicParameter(text) {
Line 1798: function formatUsageLineForParameters(parameters, args) {
Line 1839: positionalUsage = [wrapVariadicParameter(positional.parameter.placeholder ?? "args")];
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1786: function wrapVariadicFlag(text) {
1787: return `${text}...`;
1788: }
1789: function wrapRequiredParameter(text) {
1790: return `<${text}>`;
1791: }
1792: function wrapOptionalParameter(text) {
1793: return `[<${text}>]`;
1794: }
1795: function wrapVariadicParameter(text) {
1796: return `<${text}>...`;
1797: }
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? {}).filter(([, flag]) => {
1800: if (flag.hidden) {
1801: return false;
1802: }
1803: if (args.config.onlyRequiredInUsageLine && isOptionalAtRuntime(flag)) {
(Showing lines 1786-1803 of 2335. Use offset=1804 to continue.)
</content>
<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 ...
No files found
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 ...
No files found
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,184 +1,203 @@
/**
* 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 { ...
.../src/fragments/commands/agent-conversation.md | 36 ----------- .../plugins/sentry-cli/skills/sentry-cli/SKILL.md | 42 ++++++------- .../skills/sentry-cli/references/alert.md | 6 +- .../sentry-cli/skills/sentry-cli/references/cli.md | 4 +- .../skills/sentry-cli/references/explore.md | 2 +- .../skills/sentry-cli/references/feedback.md | 2 +- .../skills/sentry-cli/references/init.md | 2 +- .../skills/sentry-cli/references/issue.md | 2 +- .../skills/sentry-cli/references/monitor.md | 2 +- .../sentry-cli/skills/sentry-cli/references/org.md | 2 +- .../skills/sentry-cli/references/project.md | 4 +- .../skills/sentry-cli/references/release.md | 4 +- .../skills/sentry-cli/references/replay.md | 2 +- .../skills/sentry-cli/references/repo.md | 2 +- .../skills/sentry-cli/references/team.md | 2 +- .../skills/sentry-cli/references/trace.md | 2 +- ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
No files found
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
@@ -154,100 +154,128 @@ describe("buildCommand", () => {
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 parameters", () => {
const command = buildCommand({
auth: false,
docs: { brief: "Simple command" },
parameters: {},
async *func() {
// no-op
},
});
expect(command).toBeDefined();
});
test("retains the primary custom usage line for introspection", () => {
...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
No files found
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
No files found
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 43: (listCommand as unknown as { __primaryUsage?: string }).__primaryUsage
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 250: __primaryUsage: "<name>:<kind>...",
Line 274: const cmd = makeCommand({ __examples: examples });
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 200: (command as unknown as { __primaryUsage?: string }).__primaryUsage
Line 222: expect((command as unknown as { __examples?: unknown }).__examples).toEqual(
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path> <type>file</type> <content> 120: /** 121: * Preferred display order for routes in the SKILL.md index. 122: * Routes not listed here appear after these in alphabetical order. 123: */ 124: const ROUTE_ORDER = ["help", "auth", "org", "project", "issue", "event", "api"]; 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. ...
Found 4 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 107: * `customUsage` is present, its first line is the canonical signature suffix; Line 464: const primaryUsage = docs.customUsage?.[0]; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts: Line 609: customUsage: ["[<org>/]<name>:<platform>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 63: customUsage: [USAGE],
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts: Line 1423: readonly customUsage?: readonly (string | CustomUsage)[];
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path> <type>file</type> <content> 1390: * - `false`: `"false"`, `"f"`, `"no"`, `"n"`, `"off"`, `"0"` 1391: * 1392: * Parsers are only executed when an input is provided, 1393: * so the empty string is treated as a truthy value (i.e. a flag that is present but has no value is treated as `true`). 1394: */ 1395: declare const looseBooleanParser: (input: string) => boolean; 1396: 1397: /** 1398: * Creates an input parser that checks if the input string is found in a list of choices. 1399: */ 1400: declare function buildChoiceParser<T extends string>(choices: readonly T[]): InputParser<T>; 1401: 1402: /** 1403: * Parses input strings as numbers. ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2005: if (customUsage) {
Line 2006: for (const usage of customUsage) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1985: if (def.default) {
1986: const defaultKeyword = args.ansiColor ? `\x1B[2m${keywords.default}\x1B[22m` : keywords.default;
1987: suffix = `[${defaultKeyword} ${def.default}]`;
1988: }
1989: return [
1990: args.ansiColor ? `\x1B[1m${name}\x1B[22m` : name,
1991: args.ansiColor ? `\x1B[3m${def.brief}\x1B[23m` : def.brief,
1992: suffix ?? ""
1993: ];
1994: }),
1995: [" ", " "]
1996: );
1997: }
1998:
1999: // src/routing/command/documentation.ts
2000: function* generateCommandHelpLines(parameters, docs, args) {
2001: const { brief, fullDescription, customUsage } = docs;
2002: const { headers } = args.text;
2003: const prefix = args.prefix.join(" ");
2004: yield args.ansiColor ? `\x1B[4m${headers.usage}\x1B[24m` : headers.usage;
2005: if (customUsage) {
2006: for ...
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 2093: function buildCommand(builderArgs) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
2080: if (flag.variadic.length < 1) {
2081: throw new InternalError(
2082: `Unable to use "" as variadic separator for --${internalFlagName} as it is empty`
2083: );
2084: }
2085: if (/\s/.test(flag.variadic)) {
2086: throw new InternalError(
2087: `Unable to use "${flag.variadic}" as variadic separator for --${internalFlagName} as it contains whitespace`
2088: );
2089: }
2090: }
2091: }
2092: }
2093: function buildCommand(builderArgs) {
2094: const { flags = {}, aliases = {} } = builderArgs.parameters;
2095: checkForReservedFlags(flags, ["help", "helpAll", "help-all"]);
2096: checkForReservedAliases(aliases, ["h"]);
2097: checkForNegationCollisions(flags);
2098: checkForInvalidVariadicSeparators(flags);
2099: let loader;
2100: if ("func" in builderArgs) ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/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: ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_083df8352001mYrfSbCTcpwX9H
// Only append default if the brief doesn't already mention it
if (
flag.default !== undefined &&
flag.kind !== "boolean" &&
!desc.includes("default:")
) {
desc += ` (default: ${JSON.stringify(flag.default)})`;
}
return `| \`${syntax}\` | ${desc} |`;
}
/**
* Escape angle brackets in text so they render as literal `<` / `>`
* in HTML output rather than being interpreted as HTML tags.
*/
function escapeAngleBrackets(text: string): string {
return text.replace(/</g, "<").replace(/>/g, ">");
}
/** Format positional arguments as a markdown table */
function formatPositionalsTable(positionals: PositionalInfo[]): string {
if (positionals.length === 0) {
return "";
}
const lines: string[] = [];
lines.push("**Arguments:**");
lines.push("");
lines.push("| Argument | Description |");
...
<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/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? {}).filter(([, flag]) => {
1800: if (flag.hidden) {
1801: return false;
1802: }
1803: if (args.config.onlyRequiredInUsageLine && isOptionalAtRuntime(flag)) {
1804: return false;
1805: }
1806: return true;
1807: }).map(([name, flag]) => {
1808: let displayName = args.config.caseStyle === "convert-camel-to-kebab" ? `--${convertCamelCaseToKebabCase(name)}` : `--${name}`;
1809: if (parameters.aliases && args.config.useAliasInUsageLine) {
1810: const aliases = Object.entries(parameters.aliases).filter((entry) => entry[1] === name);
1811: if (aliases.length === 1 && aliases[0]) {
1812: displayName = `-${aliases[0][0]}`;
1813: }
1814: }
1815: if (flag.kind === ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M ../../apps/cli-docs/src/fragments/commands/agent-conversation.md M plugins/sentry-cli/skills/sentry-cli/SKILL.md M plugins/sentry-cli/skills/sentry-cli/references/alert.md M plugins/sentry-cli/skills/sentry-cli/references/cli.md M plugins/sentry-cli/skills/sentry-cli/references/explore.md M plugins/sentry-cli/skills/sentry-cli/references/feedback.md M plugins/sentry-cli/skills/sentry-cli/references/init.md M plugins/sentry-cli/skills/sentry-cli/references/issue.md M plugins/sentry-cli/skills/sentry-cli/references/monitor.md M plugins/sentry-cli/skills/sentry-cli/references/org.md M plugins/sentry-cli/skills/sentry-cli/references/project.md M plugins/sentry-cli/skills/sentry-cli/references/release.md M plugins/sentry-cli/skills/sentry-cli/references/replay.md M plugins/sentry-cli/skills/sentry-cli/references/repo.md M plugins/sentry-cli/skills/sentry-cli/references/team.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
650: if (items.length === 2) {
651: return `${items[0]} or ${items[1]}`;
652: }
653: return `${items.slice(0, -1).join(", ")}, or ${items.at(-1)}`;
654: }
655:
656: // ---------------------------------------------------------------------------
657: // Human Rendering of Introspection Data
658: // ---------------------------------------------------------------------------
659:
660: /**
661: * Format a single flag for human display.
662: *
663: * @param flag - The flag info to format
664: * @param aliases - Command alias map for short flag lookup
665: * @returns Formatted flag string like "-l, --limit <value> - Max items"
666: */
667: function formatFlagHuman(
668: flag: import("./introspect.js").FlagInfo,
669: aliases: Record<string, string>
670: ): string {
671: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
672: let syntax ...
No files found
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts -- agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. Error: API request failed: 404 Not Found Endpoint: /organizations/--help/agents/conversations/ Not found ELIFECYCLE Command failed with exit code 30.
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation view --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation view [<org>/]<conversation-id> sentry agent-conversation view --help View the full transcript of an agent conversation. The org is optional and auto-detected from your project context when omitted. Prefix the ID with an org slug to target a specific org. ...
No files found
rg: regex parse error:
(?:positional:\s*\{\s*kind:\s*"tuple",\s*parameters:\s*\[\s*\{(?:(?!\}\s*,?\s*\]).)*\bdefault:)
^^^
error: look-around, including look-ahead and look-behind, is not supported
Consider enabling PCRE2 with the --pcre2 flag, which can handle backreferences
and look-around.
(no output)
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts</path>
<type>file</type>
<content>
1: /**
2: * Shared building blocks for mutation (create/delete) commands.
3: *
4: * Provides reusable Stricli parameter definitions, safety utilities, and a
5: * `buildDeleteCommand` wrapper — paralleling `list-command.ts` for list commands.
6: *
7: * Level A — shared constants (used by create and delete commands):
8: * DRY_RUN_FLAG, YES_FLAG, FORCE_FLAG,
9: * DESTRUCTIVE_FLAGS, DESTRUCTIVE_ALIASES, DRY_RUN_ALIASES
10: *
11: * Level B — shared utilities:
12: * isConfirmationBypassed, guardNonInteractive, confirmByTyping,
13: * requireExplicitTarget
14: *
15: * Level C — delete command builder:
16: * buildDeleteCommand
17: */
18:
19: import { isatty } from "node:tty";
20: import type { Command, CommandContext } from "@stricli/core";
21: import type { ParsedOrgProject } from "./arg-parsing.js";
22: import { buildCommand, type ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts</path>
<type>file</type>
<content>
300: * since the prompt depends on data resolved during execution.
301: *
302: * Mirrors {@link import("./list-command.js").buildListCommand} for list commands.
303: *
304: * @param builderArgs - Same arguments as `buildCommand` from `lib/command.js`
305: * @param options - Control which flags are auto-injected
306: *
307: * @example
308: * ```ts
309: * export const deleteCommand = buildDeleteCommand({
310: * docs: { brief: "Delete a widget" },
311: * output: { human: formatWidgetDeleted },
312: * parameters: {
313: * positional: { ... },
314: * flags: { index: { ... } },
315: * aliases: { i: "index" },
316: * },
317: * async *func(this: SentryContext, flags, ...args) {
318: * // --yes, --force, --dry-run are available on flags
319: * if (flags["dry-run"]) { yield preview; return; }
320: * if ...
<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> 530: * This is a drop-in replacement for `buildCommand` that: 531: * 1. Intercepts subcommand names passed through plural aliases 532: * 2. Auto-injects `--fresh` and `--cursor` flags (unless already defined) 533: * 3. Auto-injects `-f` and `-c` aliases (with opt-outs via `options`) 534: * 4. Auto-calls `applyFreshFlag(flags)` before the command function runs 535: * 536: * Commands that define their own `cursor` or `fresh` flags (e.g., with a 537: * custom `brief`) keep theirs — auto-injection skips flags already present. 538: * 539: * @param routeName - Singular route name (e.g. "project", "issue") for the 540: * hint message and subcommand lookup 541: * @param builderArgs - Same arguments as `buildCommand` from `lib/command.js` 542: * @param options - Control which flags are auto-injected 543: */ 544: export function buildListCommand< 545: const FLAGS ...
.../src/fragments/commands/agent-conversation.md | 36 ----------- .../plugins/sentry-cli/skills/sentry-cli/SKILL.md | 42 ++++++------- .../skills/sentry-cli/references/alert.md | 6 +- .../sentry-cli/skills/sentry-cli/references/cli.md | 4 +- .../skills/sentry-cli/references/explore.md | 2 +- .../skills/sentry-cli/references/feedback.md | 2 +- .../skills/sentry-cli/references/init.md | 2 +- .../skills/sentry-cli/references/issue.md | 2 +- .../skills/sentry-cli/references/monitor.md | 2 +- .../sentry-cli/skills/sentry-cli/references/org.md | 2 +- .../skills/sentry-cli/references/project.md | 4 +- .../skills/sentry-cli/references/release.md | 4 +- .../skills/sentry-cli/references/replay.md | 2 +- .../skills/sentry-cli/references/repo.md | 2 +- .../skills/sentry-cli/references/team.md | 2 +- .../skills/sentry-cli/references/trace.md | 2 +- ...
Found 100 matches (more matches available)
/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/AGENTS.md:
Line 149: fullDescription: "Detailed description",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 37: fullDescription?: string;
Line 46: fullDescription?: string;
Line 105: fullDescription?: string;
...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
Checked 15 files in 2s. No fixes applied.
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: title: agent-conversation 3: description: Agent-conversation commands for the Sentry CLI 4: --- 5: 6: List and view agent conversations 7: 8: ## Commands 9: 10: ### `sentry agent-conversation list [<org>]` 11: 12: List recent agent conversations 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<org>]` | Organization slug | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-n, --limit <limit>` | Number of conversations (1-1000) (default: "25") | 25: | `-q, --query <query>` | Search query | 26: | `-t, --period <period>` | Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" (default: "7d") | 27: | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data | 28: | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts project create --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry project create [<org>/]<name>:<platform>... sentry project create --help Create Sentry projects in an organization. Names support org/name syntax to specify the organization explicitly. If omitted, the org is auto-detected from config defaults. Project names cannot contain whitespace. Every project is a name:platform pair. Create several projects at once by passing multiple pairs as separate arguments. All projects share one org. Projects are created under a team. If the org has one team, it is used automatically. If no teams exist, one is created. Otherwise, specify --team. ...
<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 ...
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 ...
...output truncated... Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_083eee3c0001ZC9z2UFWY5xZOS -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` ### Project Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view [<org/project>]` — View details of a project → Full flags and examples: `references/project.md` ### Issue Manage Sentry issues -- `sentry issue list <org/project>` — List issues in a project +- `sentry issue list [<org/project>]` — List issues in a project - `sentry issue events <issue>` — List ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md packages/cli/src/generated/banner-sixel.ts
Found 5 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 820: if (positional.kind === "array") {
Line 993: if (positional.kind === "array") {
Line 1838: if (positional.kind === "array") {
Line 1968: if (positional.kind === "array") {
Line 2037: if (positional.kind === "array" || positional.parameters.length > 0) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1940: return formatRowsWithColumns(
1941: rows.map((row) => {
1942: if (!args.ansiColor) {
1943: return [row.aliases, row.flagName, row.brief, row.suffix ?? ""];
1944: }
1945: return [
1946: row.hidden ? `\x1B[2m${row.aliases}\x1B[22m` : `\x1B[1m${row.aliases}\x1B[22m`,
1947: row.hidden ? `\x1B[2m${row.flagName}\x1B[22m` : `\x1B[1m${row.flagName}\x1B[22m`,
1948: row.hidden ? `\x1B[2;3m${row.brief}\x1B[22;23m` : `\x1B[;;3m${row.brief}\x1B[;;;23m`,
1949: row.suffix ?? ""
1950: ];
1951: }),
1952: [" ", " ", " "]
1953: );
1954: }
1955: function* generateBuiltInFlagUsageLines(args) {
1956: yield args.config.useAliasInUsageLine ? "-h" : "--help";
1957: if (args.includeHelpAllFlag) {
1958: const helpAllFlagName = formatForDisplay("helpAll", args.config.caseStyle);
1959: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1800: if (flag.hidden) {
1801: return false;
1802: }
1803: if (args.config.onlyRequiredInUsageLine && isOptionalAtRuntime(flag)) {
1804: return false;
1805: }
1806: return true;
1807: }).map(([name, flag]) => {
1808: let displayName = args.config.caseStyle === "convert-camel-to-kebab" ? `--${convertCamelCaseToKebabCase(name)}` : `--${name}`;
1809: if (parameters.aliases && args.config.useAliasInUsageLine) {
1810: const aliases = Object.entries(parameters.aliases).filter((entry) => entry[1] === name);
1811: if (aliases.length === 1 && aliases[0]) {
1812: displayName = `-${aliases[0][0]}`;
1813: }
1814: }
1815: if (flag.kind === "boolean") {
1816: return [flag, displayName];
1817: }
1818: if (flag.kind === "enum" && typeof flag.placeholder !== "string") {
1819: ...
<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: ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs /tmp/opencode/check-fragments-head.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
node:internal/modules/run_main:107
triggerUncaughtException(
^
Error: Transform failed with 7 errors:
/tmp/opencode/check-fragments-head.ts:24:27: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-head.ts:30:2: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-head.ts:36:19: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-head.ts:37:29: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-head.ts:94:18: ERROR: Top-level await is currently not supported with the ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/proguard.md</path> <type>file</type> <content> 1: 2: 3: ## Examples 4: 5: ```bash 6: # Compute the UUID for a ProGuard/R8 mapping file 7: sentry proguard uuid ./app/build/outputs/mapping/release/mapping.txt 8: 9: # Output as JSON (includes the file path) 10: sentry proguard uuid mapping.txt --json 11: ``` 12: 13: ## Important Notes 14: 15: - The UUID is **deterministically derived from the mapping file contents** — 16: identical files always produce the same UUID. This is the same value 17: Sentry uses to associate a mapping with obfuscated Android stack traces. 18: - This matches the UUID computed by the legacy `sentry-cli proguard uuid` 19: command byte-for-byte. (End of file - total 19 lines) </content>
> sentry@0.45.0-dev.0 generate:command-docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-command-docs.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-command-docs.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated 36 command doc pages + ../../apps/cli-docs/src/content/docs/commands/index.md + ../../apps/cli-docs/src/content/docs/configuration.md > sentry@0.45.0-dev.0 generate:skill /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-skill.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-skill.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated ...
Found 29 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 59: extractRouteGroupCommands,
Line 67: * Hidden dispatcher routes (e.g. auth's `default`) map bare group examples
Line 81: // Auth uses a hidden "default" dispatcher; bare `sentry auth` examples
Line 345: * Initializes each path with an empty array in the examples map.
Line 349: examples: Map<string, string[]>
Line 359: if (!examples.has(cmdPath)) {
Line 360: examples.set(cmdPath, []);
Line 376: examples: Map<string, string[]>;
Line 380: const { commandPaths, commandGroup, examples, defaultCommandPath } = context;
Line 392: if (currentCmd && examples.has(currentCmd)) {
Line 393: appendExample(examples, currentCmd, code);
Line 402: appendExample(examples, target, code);
Line 409: * Load examples for a specific command group from docs using the `marked`
Line 417: async function ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
330: }
331:
332: /** Append a code block to a map entry, creating the array if needed */
333: function appendExample(
334: map: Map<string, string[]>,
335: key: string,
336: code: string
337: ): void {
338: const list = map.get(key) ?? [];
339: list.push(code);
340: map.set(key, list);
341: }
342:
343: /**
344: * Collect all command paths from `### \`sentry ...\`` headings in a token list.
345: * Initializes each path with an empty array in the examples map.
346: */
347: function collectCommandPaths(
348: tokens: Token[],
349: examples: Map<string, string[]>
350: ): string[] {
351: const paths: string[] = [];
352: for (const token of tokens) {
353: if (token.type !== "heading" || token.depth !== 3) {
354: continue;
355: }
356: const cmdPath = extractCommandPathFromHeading(token.text);
357: if (cmdPath) {
358: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts</path>
<type>file</type>
<content>
300: "install the SDK, and configure Sentry.\n\n" +
301: "Supports org/project syntax and a directory positional. Path-like\n" +
302: "arguments (starting with . / ~) are treated as the directory;\n" +
303: "everything else is treated as the target.\n\n" +
304: "Examples:\n" +
305: " sentry init\n" +
306: " sentry init acme/\n" +
307: " sentry init acme/my-app\n" +
308: " sentry init my-app\n" +
309: " sentry init acme/my-app ./my-project\n" +
310: " sentry init ./my-project",
311: },
312: parameters: {
313: positional: {
314: kind: "tuple",
315: parameters: [
316: {
317: placeholder: "target",
318: brief: "<org>/<project>, <org>/, <project>, or a directory path",
319: parse: String,
320: optional: true,
321: },
322: ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help init
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
sentry init [<target>] [<directory>]
Initialize Sentry in your project (experimental)
Flags:
-y, --yes — Accept non-interactive defaults (requires --features outside a TTY)
-n, --dry-run — Show what would happen without making changes
--features <value>... — Features to enable: errors,tracing,logs,replay,profiling,crons,agent-tracing,mcp-observability
-t, --team <value> — Team slug to create the project under
--app <value> — App to initialize in a monorepo (required with --yes when multiple apps are detected)
--tui — Use the Ink-based interactive UI (default). Pass --no-tui to fall back to plain log output.
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx ...
<path>/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md</path> <type>file</type> <content> 1: # Jared (Outpost agent) 2: 3: Autonomous GitHub coding agent. Work in `/workspace/repo`. 4: 5: ## Model tiers 6: 7: The primary model is chosen per event (see `src/agents/models.ts`): heavy for 8: code-producing situations, cheaper for lightweight ones. 9: 10: | Role | Subagent | Model | 11: | --- | --- | --- | 12: | Triage / plan / review (heavy) | (primary Jared) | Claude Opus 4.8 | 13: | Triage / plan / review (light) | (primary Jared) | xAI Grok 4.3 | 14: | Explore | `explore` | OpenAI gpt-5-mini | 15: | Implement | `implement` | Moonshot kimi-k2.7-code | 16: | Ship (commit/push/PR) | `ship` | xAI Grok (`grok-build-0.1`) | 17: 18: Pipeline: triage → explore → plan → implement → review → ship. 19: (`worker` is a deprecated alias of `implement`.) 20: 21: Operators also talk to Jared directly from the Outpost dashboard. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/.cursor/rules/ultracite.mdc</path>
<type>file</type>
<content>
1: ---
2: description: Ultracite Rules - AI-Ready Formatter and Linter
3: globs: "**/*.{ts,tsx,js,jsx,json,jsonc,html,vue,svelte,astro,css,yaml,yml,graphql,gql,md,mdx,grit}"
4: alwaysApply: false
5: ---
6:
7: # Ultracite Code Standards
8:
9: This project uses **Ultracite**, a zero-config Biome preset that enforces strict code quality standards through automated formatting and linting.
10:
11: ## Quick Reference
12:
13: - **Format code**: `npx ultracite fix`
14: - **Check for issues**: `npx ultracite check`
15: - **Diagnose setup**: `npx ultracite doctor`
16:
17: Biome (the underlying engine) provides extremely fast Rust-based linting and formatting. Most issues are automatically fixable.
18:
19: ---
20:
21: ## Core Principles
22:
23: Write code that is **accessible, performant, type-safe, and maintainable**. Focus on clarity and explicit intent over brevity. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 154: readonly docs: CommandDocumentation; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts: Line 335: readonly docs: CommandDocumentation; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts: Line 552: readonly docs: CommandDocumentation;
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path> <type>file</type> <content> 70: /** 71: * Parse a string input as a number. 72: * Re-exported from Stricli for convenience. 73: */ 74: export const numberParser = stricliNumberParser; 75: 76: /** Base flags type from Stricli */ 77: type BaseFlags = Readonly<Partial<Record<string, unknown>>>; 78: 79: /** Base args type from Stricli */ 80: type BaseArgs = readonly unknown[]; 81: 82: /** 83: * Type-erased Stricli builder arguments. 84: * 85: * At the `stricliCommand()` call site we've modified both `parameters` 86: * (injected hidden flags) and `func` (wrapped with telemetry/output 87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment 88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`. ...
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist</path> <type>directory</type> <entries> index.cjs index.d.cts index.d.ts index.js (4 entries) </entries>
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 1426: type BaseCommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = {
Line 1436: type LazyCommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = {
Line 1441: } & NoInfer<BaseCommandBuilderArguments<FLAGS, ARGS, CONTEXT>>;
Line 1442: type LocalCommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = {
Line 1447: } & NoInfer<BaseCommandBuilderArguments<FLAGS, ARGS, CONTEXT>>;
Line 1448: type CommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = LazyCommandBuilderArguments<FLAGS, ARGS, CONTEXT> | LocalCommandBuilderArguments<FLAGS, ARGS, CONTEXT>;
Line 1452: declare function buildCommand<const FLAGS extends Readonly<Partial<Record<keyof FLAGS, unknown>>> ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path> <type>file</type> <content> 1370: readonly InternalError: -1; 1371: /** 1372: * Command executed successfully. 1373: */ 1374: readonly Success: 0; 1375: /** 1376: * Command module unexpectedly threw an error. 1377: */ 1378: readonly CommandRunError: 1; 1379: }; 1380: 1381: /** 1382: * Parses input strings as booleans. 1383: * Transforms to lowercase and then checks against "true" and "false". 1384: */ 1385: declare const booleanParser: (input: string) => boolean; 1386: /** 1387: * Parses input strings as booleans (loosely). ...
Found 34 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 70: | { kind: "array"; parameter: PositionalParam };
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 484: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 130: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts:
Line 384: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts:
Line 575: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/send-envelope.ts:
Line 26: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/schema.ts:
Line 324: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/view.ts:
Line 360: kind: ...
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/issue/resolve.ts: Line 127: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 594: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/archive.ts: Line 368: optional: ...
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 496: default: false, Line 501: default: false, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 142: default: false, Line 148: default: DEFAULT_PERIOD, Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging Line 167: default: "newest", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 238: default: String(LIST_DEFAULT_LIMIT), Line 250: default: "date" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts: Line 43: default: SENTRY_STATUS_PAGE_URL, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 587: default: String(LIST_DEFAULT_LIMIT), Line 600: default: ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
(no output)
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 30: function makeCommand(overrides: Partial<Command> = {}): Command {
<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: ...
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2022: yield fullDescription ?? brief;
Line 2113: get fullDescription() {
Line 2114: return builderArgs.docs.fullDescription;
Line 2134: const { brief, fullDescription, hideRoute } = docs;
Line 2151: yield fullDescription ?? brief;
Line 2233: get fullDescription() {
Line 2234: return docs.fullDescription;
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
2090: }
2091: }
2092: }
2093: function buildCommand(builderArgs) {
2094: const { flags = {}, aliases = {} } = builderArgs.parameters;
2095: checkForReservedFlags(flags, ["help", "helpAll", "help-all"]);
2096: checkForReservedAliases(aliases, ["h"]);
2097: checkForNegationCollisions(flags);
2098: checkForInvalidVariadicSeparators(flags);
2099: let loader;
2100: if ("func" in builderArgs) {
2101: loader = async () => builderArgs.func;
2102: } else {
2103: loader = builderArgs.loader;
2104: }
2105: return {
2106: kind: CommandSymbol,
2107: loader,
2108: parameters: builderArgs.parameters,
2109: get brief() {
2110: return builderArgs.docs.brief;
2111: },
2112: /* v8 ignore next -- @preserve */
2113: get fullDescription() {
2114: return builderArgs.docs.fullDescription;
2115: ...
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 980: readonly positional: TypedPositionalParameters<ARGS, CONTEXT>;
Line 1054: type TypedPositionalParameters<T, CONTEXT extends CommandContext> = [T] extends [readonly (infer E)[]] ? number extends T["length"] ? PositionalParameterArray<E, CONTEXT> : PositionalParameterTuple<PositionalParametersForTuple<T, CONTEXT>> : PositionalParameterTuple<PositionalParametersForTuple<T, CONTEXT>>;
Line 1057: * This is a separate version of {@link TypedPositionalParameters} without a type parameter and is primarily used
Line 1506: export { AliasNotFoundError, type Aliases, type Application, type ApplicationConfiguration, type ApplicationContext, type ApplicationErrorFormatting, type ApplicationText, ArgumentParseError, ArgumentScannerError, type BaseArgs, type BaseFlags, type Command, type CommandBuilderArguments, type CommandContext, type CommandFunction, type ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/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?: false;
1019: }
1020: interface OptionalPositionalParameter<T, CONTEXT extends CommandContext> extends ...
No files found
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/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 = nextFlags[0].namedFlag;
796: }
797: return;
798: }
799: }
800: ...
<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/project/create.ts</path>
<type>file</type>
<content>
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. Create several projects at once\n" +
616: "by passing multiple pairs as separate arguments. All projects share one org.\n\n" +
617: "Projects are created under a team. ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 1795: function wrapVariadicParameter(text) {
Line 1839: positionalUsage = [wrapVariadicParameter(positional.parameter.placeholder ?? "args")];
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1778:
1779: // src/parameter/formatting.ts
1780: function wrapRequiredFlag(text) {
1781: return `(${text})`;
1782: }
1783: function wrapOptionalFlag(text) {
1784: return `[${text}]`;
1785: }
1786: function wrapVariadicFlag(text) {
1787: return `${text}...`;
1788: }
1789: function wrapRequiredParameter(text) {
1790: return `<${text}>`;
1791: }
1792: function wrapOptionalParameter(text) {
1793: return `[<${text}>]`;
1794: }
1795: function wrapVariadicParameter(text) {
1796: return `<${text}>...`;
1797: }
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? {}).filter(([, flag]) => {
1800: if (flag.hidden) {
1801: return false;
1802: }
(Showing lines 1778-1802 of 2335. Use offset=1803 to continue.)
</content>
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 465: function parseProjectSpecs(rawSpecs: readonly string[]): {
Line 658: const { explicitOrg, parsed } = parseProjectSpecs(args);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
450: }
451:
452: const rawName = rawSpec.slice(0, separatorIndex);
453: const platform = parseProjectPlatform(
454: rawName,
455: rawSpec.slice(separatorIndex + 1)
456: );
457: return parseProjectName(rawName, platform);
458: }
459:
460: /**
461: * Parse one or more `[<org>/]<name>:<platform>` pairs, then require explicit
462: * org prefixes to agree. A lone positional with no colon at all gets a
463: * friendlier "platform is required" error instead of the generic syntax error.
464: */
465: function parseProjectSpecs(rawSpecs: readonly string[]): {
466: explicitOrg?: string;
467: parsed: ParsedProjectSpec[];
468: } {
469: if (rawSpecs.length === 0) {
470: throw new ContextError("Project specification", USAGE_HINT, []);
471: }
472:
473: if (rawSpecs.length === 1 && !rawSpecs[0]?.includes(":")) {
474: throw new ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-parser.ts > sentry@0.45.0-dev.0 tsx ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Validate doc fragment files.
4: *
5: * Ensures fragment files stay consistent with the CLI route tree:
6: * 1. Every route has a corresponding fragment file (+ index.md)
7: * 2. Every fragment file corresponds to an existing route (or is index.md)
8: * 3. Fragment files don't accidentally contain frontmatter or the generated marker
9: * 4. Top-level fragments (e.g., configuration.md) exist
10: * 5. Fragment content covers all subcommands in a route (warnings only)
11: *
12: * Usage:
13: * tsx script/check-fragments.ts # Warnings for missing subcommands
14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
15: */
16:
17: import { mkdirSync, readdirSync } from "node:fs";
18: import { access, readFile, writeFile } from "node:fs/promises";
19: import type { RouteInfo, RouteMap ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry status show
3: *
4: * Report the current status of Sentry's services by querying the public
5: * Statuspage backend at https://status.sentry.io. Useful when the Sentry API
6: * is degraded and you want to know whether the problem is on Sentry's side.
7: */
8:
9: import type { SentryContext } from "../../context.js";
10: import {
11: fetchSentryStatus,
12: SENTRY_STATUS_PAGE_URL,
13: } from "../../lib/api/status-page.js";
14: import { buildCommand } from "../../lib/command.js";
15: import { formatSentryStatus } from "../../lib/formatters/human.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17:
18: type ShowFlags = {
19: readonly json: boolean;
20: readonly url: string;
21: readonly fields?: string[];
22: };
23:
24: export const showCommand = buildCommand({
25: // Checking the public status page requires ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/completion.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry cli completion <shell>
3: *
4: * Print the shell completion script to stdout. Unlike `cli setup`, which writes
5: * completion files to disk, this command lets users and package managers install
6: * completions however they like.
7: *
8: * Usage:
9: * sentry cli completion zsh > ~/.local/share/zsh/site-functions/_sentry
10: * eval "$(sentry cli completion bash)"
11: *
12: * When no shell is given, the current shell is detected from $SHELL.
13: */
14:
15: import type { SentryContext } from "../../context.js";
16: import { buildCommand } from "../../lib/command.js";
17: import { getCompletionScript } from "../../lib/completions.js";
18: import { ValidationError } from "../../lib/errors.js";
19: import { CommandOutput } from "../../lib/formatters/output.js";
20: import { detectShellType } from "../../lib/shell.js";
21:
22: export ...
# branch.oid bbaa7b3b722b87f1bccfe84063269cbbcabe2741 # branch.head fix/agent-conversation-reference-root-cause # branch.upstream origin/pr-1558 1 .M N... 100644 100644 100644 3fa952c15068d8aaadd678be3a0c07cd2ec104d2 3fa952c15068d8aaadd678be3a0c07cd2ec104d2 apps/cli-docs/src/fragments/commands/agent-conversation.md 1 .M N... 100644 100644 100644 8422018c28b681b72b3652cfaa1519763050d80e 8422018c28b681b72b3652cfaa1519763050d80e packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md 1 .M N... 100644 100644 100644 60f3eabf688f80c4dbd665b5beaddc3a4acafda6 60f3eabf688f80c4dbd665b5beaddc3a4acafda6 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md 1 .M N... 100644 100644 100644 05510325ce95b26e989e14abfc9f8a1475be7242 05510325ce95b26e989e14abfc9f8a1475be7242 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md 1 .M N... ...
<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: ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
diff --git a/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 ...
{"baseRefName":"main","body":"The agent-conversation reference currently shows `sentry agent-conversation view my-org conv-123`, but `view` accepts one `[<org>/]<conversation-id>` positional argument. The list and view headings also make the organization appear mandatory even though both support detection.\n\nCorrect the authoritative examples to use `my-org/conv-123`, include the detected-organization form, and add command-specific usage metadata. Regenerate the skill index/reference with the existing generator. Command execution and argument parsing are unchanged.\n\nValidation:\n\n- Both new documentation regressions fail against current main before the correction.\n- Generated API schema, SDK, command docs and skills through the existing scripts.\n- 101 focused command, API, formatter and documentation tests passed across five files.\n- Biome checked the three TypeScript files with no fixes or ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? {}).filter(([, flag]) => {
1800: if (flag.hidden) {
1801: return false;
1802: }
1803: if (args.config.onlyRequiredInUsageLine && isOptionalAtRuntime(flag)) {
1804: return false;
1805: }
1806: return true;
1807: }).map(([name, flag]) => {
1808: let displayName = args.config.caseStyle === "convert-camel-to-kebab" ? `--${convertCamelCaseToKebabCase(name)}` : `--${name}`;
1809: if (parameters.aliases && args.config.useAliasInUsageLine) {
1810: const aliases = Object.entries(parameters.aliases).filter((entry) => entry[1] === name);
1811: if (aliases.length === 1 && aliases[0]) {
1812: displayName = `-${aliases[0][0]}`;
1813: }
1814: }
1815: if (flag.kind === ...
cp: cannot stat 'packages/cli/script/check-fragments.ts': No such file or directory cp: cannot stat '/tmp/opencode/check-fragments-patched.ts': No such file or directory
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 286: export function buildCommandInfo(
Line 336: commands.push(buildCommandInfo(subTarget, path, examples));
Line 378: commands: [buildCommandInfo(target, path)],
Line 453: info: buildCommandInfo(target, `sentry ${entry.name.original}`),
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
260: */
261: export function extractFlags(
262: flags: Record<string, FlagDef> | undefined
263: ): FlagInfo[] {
264: if (!flags) {
265: return [];
266: }
267:
268: return Object.entries(flags).map(([name, def]) => ({
269: name,
270: brief: def.brief ?? "",
271: kind: def.kind,
272: default: def.default,
273: optional: def.optional ?? def.kind === "boolean",
274: variadic: def.variadic ?? false,
275: hidden: def.hidden ?? false,
276: }));
277: }
278:
279: /**
280: * Build a {@link CommandInfo} from a Stricli Command.
281: *
282: * @param cmd - The Stricli command to introspect
283: * @param path - Full command path (e.g. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
700: }
701:
702: lines.push(`### ${capitalize(route.name)}`);
703: lines.push("");
704: lines.push(route.brief);
705: lines.push("");
706:
707: for (const cmd of route.commands) {
708: lines.push(generateCompactCommandLine(cmd));
709: }
710:
711: // Add reference file pointer (1:1 route-to-file mapping)
712: const refFile = referenceFiles.get(route.name);
713: if (refFile) {
714: lines.push("");
715: lines.push(`→ Full flags and examples: \`references/${refFile}\``);
716: }
717:
718: lines.push("");
719: }
720:
721: return lines.join("\n");
722: }
723:
724: /** Generate supplementary sections (Global Options, Output Formats) from docs */
725: async function generateSupplementarySections(): Promise<string> {
726: const overview = await loadCommandsOverview();
727: const lines: string[] = ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 59: extractRouteGroupCommands,
Line 477: async function extractRoutes(routeMap: RouteMap): Promise<RouteInfo[]> {
Line 496: commands: extractRouteGroupCommands(target, routeName, docExamples),
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
410: * AST parser. Walks the token tree to find command headings and associate
411: * bash code blocks with each command.
412: *
413: * Handles both auto-generated reference sections (`### \`sentry ...\`` headings)
414: * and hand-written custom sections (`## Examples` with descriptive headings)
415: * by matching code blocks to commands via heading context or content analysis.
416: */
417: async function loadCommandExamples(
418: commandGroup: string,
419: defaultCommandName?: string
420: ): Promise<Map<string, string[]>> {
421: const docContent = await loadDoc(`commands/${commandGroup}.md`);
422: if (!docContent) {
423: return new Map();
424: }
425:
426: const tokens = marked.lexer(docContent);
427: const examples = new Map<string, string[]>();
428: const commandPaths = collectCommandPaths(tokens, examples);
429: const defaultCommandPath = ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 371: function associateCodeBlocks(
Line 432: associateCodeBlocks(tokens, {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
300: }
301:
302: /** Default prerequisites if docs aren't available */
303: function getDefaultPrerequisites(): string {
304: return `## Prerequisites
305:
306: The CLI must be installed and authenticated before use.
307:
308: ### Installation
309:
310: \`\`\`bash
311: # Install script
312: curl https://cli.sentry.dev/install -fsS | bash
313:
314: # Or use npm/pnpm/bun
315: npm install -g sentry
316: \`\`\`
317:
318: ### Authentication
319:
320: \`\`\`bash
321: # OAuth login (recommended)
322: sentry auth
323:
324: # Or use an API token
325: sentry auth --token YOUR_SENTRY_API_TOKEN
326:
327: # Check auth status
328: sentry auth status
329: \`\`\``;
330: }
331:
332: /** Append a code block to a map entry, creating the array if needed */
333: function appendExample(
334: map: Map<string, string[]>,
335: key: string,
336: code: string
337: ): void {
338: ...
<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 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts: Line 57: "**Examples:**",
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
390: * @param builderArgs - Same shape as Stricli's buildCommand arguments,
391: * plus an optional `output` mode
392: * @returns A fully-wrapped Stricli Command
393: */
394:
395: /**
396: * Build the `--fields` flag definition, enriched with available field names
397: * when a schema is registered on the output config.
398: */
399: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
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}. ...
<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 ...
Found 7 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts:
Line 16: formatHelpHuman,
Line 31: human: formatHelpHuman,
Line 49: // formatHelpHuman (human output only), so `--json` never triggers the
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 709: const { introspectCommand, formatHelpHuman } = await import("./help.js");
Line 719: stdout.write(`${formatHelpHuman(result)}\n`);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 298: * passes through {@link formatHelpHuman}, which renders the branded banner for
Line 764: export function formatHelpHuman(data: HelpJsonResult): string {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
650: if (items.length === 2) {
651: return `${items[0]} or ${items[1]}`;
652: }
653: return `${items.slice(0, -1).join(", ")}, or ${items.at(-1)}`;
654: }
655:
656: // ---------------------------------------------------------------------------
657: // Human Rendering of Introspection Data
658: // ---------------------------------------------------------------------------
659:
660: /**
661: * Format a single flag for human display.
662: *
663: * @param flag - The flag info to format
664: * @param aliases - Command alias map for short flag lookup
665: * @returns Formatted flag string like "-l, --limit <value> - Max items"
666: */
667: function formatFlagHuman(
668: flag: import("./introspect.js").FlagInfo,
669: aliases: Record<string, string>
670: ): string {
671: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
672: let syntax ...
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts: Line 686: export function buildOrgListCommand<TEntity, TWithOrg>(
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path>
<type>file</type>
<content>
620: parameters: mergedParams,
621: func: wrappedFunc,
622: output: builderArgs.output,
623: });
624: }
625:
626: // ---------------------------------------------------------------------------
627: // Level D: full command builder for dispatchOrgScopedList-based commands
628: // ---------------------------------------------------------------------------
629:
630: /** Documentation for a list command built with `buildOrgListCommand`. */
631: export type OrgListCommandDocs = CommandDocumentation;
632:
633: /**
634: * Format a {@link ListResult} as human-readable output using the config's
635: * `displayTable` function. Handles empty results, headers, table body, and hints. ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts:
Line 9: * LIST_TARGET_POSITIONAL, LIST_JSON_FLAG, LIST_CURSOR_FLAG,
Line 73: export const LIST_TARGET_POSITIONAL = {
Line 700: positional: LIST_TARGET_POSITIONAL,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path> <type>file</type> <content> 50: // Level A: shared parameter / flag definitions 51: // --------------------------------------------------------------------------- 52: 53: /** 54: * Absolute maximum items a list command will return. 55: * 56: * The Sentry API silently caps `per_page` at 100; commands auto-paginate 57: * to fill larger limits but stop at this ceiling for practical CLI use. 58: */ 59: export const LIST_MAX_LIMIT = 1000; 60: 61: /** Minimum allowed value for `--limit` across all list commands. */ 62: export const LIST_MIN_LIMIT = 1; 63: 64: /** Default number of items returned by list commands when `--limit` is omitted. */ 65: export const LIST_DEFAULT_LIMIT = 25; 66: 67: /** 68: * Positional `org/project` parameter shared by all list commands. 69: * 70: * Accepts `<org>/`, `<org>/<project>`, or bare `<project>` (search). ...
Found 11 matches
/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
/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;
Found 2 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 63: customUsage: [USAGE],
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs /tmp/opencode/check-fragments-base.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
node:internal/modules/run_main:107
triggerUncaughtException(
^
Error: Transform failed with 7 errors:
/tmp/opencode/check-fragments-base.ts:24:27: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base.ts:30:2: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base.ts:36:19: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base.ts:37:29: ERROR: Top-level await is currently not supported with the "cjs" output format
/tmp/opencode/check-fragments-base.ts:94:18: ERROR: Top-level await is currently not supported with the ...
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.base-review.ts --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 2 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/agent-conversation.md
Not documented: list, view
Hint: add a heading or code example for each (e.g., "sentry agent-conversation list")
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
255: lines.push("");
256:
257: // Per-command sections
258: for (const cmd of route.commands) {
259: lines.push(generateCommandSection(cmd));
260: lines.push("");
261: }
262:
263: // Global flags footer
264: lines.push(
265: "All commands support `--json` for machine-readable output and `--fields` to select specific JSON fields."
266: );
267: lines.push("");
268:
269: // End marker
270: lines.push(GENERATED_END_MARKER);
271:
272: return lines.join("\n");
273: }
274:
275: /** Known acronyms that should be fully uppercased in titles */
276: const ACRONYMS = new Set(["api", "cli"]);
277:
278: function capitalize(s: string): string {
279: if (ACRONYMS.has(s)) {
280: return s.toUpperCase();
281: }
282: return s.charAt(0).toUpperCase() + s.slice(1);
283: }
284:
285: // ...
No files found
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
Found 9 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 111: examples: string[]; Line 289: examples: string[] = [] Line 304: examples: cmd.__examples?.length /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts: Line 520: examples: string[], Line 542: examples: string[], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/local.ts: Line 270: * Output examples: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/widget/index.ts: Line 47: "Row-filling examples:\n" +
No files found
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2022: yield fullDescription ?? brief;
Line 2113: get fullDescription() {
Line 2114: return builderArgs.docs.fullDescription;
Line 2134: const { brief, fullDescription, hideRoute } = docs;
Line 2151: yield fullDescription ?? brief;
Line 2233: get fullDescription() {
Line 2234: return docs.fullDescription;
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1988: }
1989: return [
1990: args.ansiColor ? `\x1B[1m${name}\x1B[22m` : name,
1991: args.ansiColor ? `\x1B[3m${def.brief}\x1B[23m` : def.brief,
1992: suffix ?? ""
1993: ];
1994: }),
1995: [" ", " "]
1996: );
1997: }
1998:
1999: // src/routing/command/documentation.ts
2000: function* generateCommandHelpLines(parameters, docs, args) {
2001: const { brief, fullDescription, customUsage } = docs;
2002: const { headers } = args.text;
2003: const prefix = args.prefix.join(" ");
2004: yield args.ansiColor ? `\x1B[4m${headers.usage}\x1B[24m` : headers.usage;
2005: if (customUsage) {
2006: for (const usage of customUsage) {
2007: if (typeof usage === "string") {
2008: yield ` ${prefix} ${usage}`;
2009: } else {
2010: const brief2 = args.ansiColor ? ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 496: default: false,
Line 501: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 142: default: false,
Line 148: default: DEFAULT_PERIOD,
Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging
Line 167: default: "newest",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 238: default: String(LIST_DEFAULT_LIMIT),
Line 250: default: "date" as const,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts:
Line 43: default: SENTRY_STATUS_PAGE_URL,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts:
Line 283: default: {
Line 324: brief: "Project directory (default: current directory)",
Line 362: ...
Found 20 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/sveltekit-app/package.json:
Line 7: "dev": "vite dev",
Line 12: "devDependencies": {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/nextjs-app/package.json:
Line 6: "dev": "next dev",
Line 8: "start": "next start"
Line 15: "devDependencies": {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/react-vite-app/package.json:
Line 7: "dev": "vite",
Line 15: "devDependencies": {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/express-app/package.json:
Line 6: "start": "node dist/index.js",
Line 12: "devDependencies": {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/package.json:
Line 25: "sentry": "./dist/bin.cjs"
Line 45: "devEngines": {
Line 54: "cli": "tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts",
...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts</path>
<type>file</type>
<content>
260: }
261:
262: // Exactly one match — use it (wizard handles existing-project flow)
263: const [match] = projects;
264: if (match) {
265: return { org: match.orgSlug, project: match.slug };
266: }
267:
268: // No project found — is the slug an org name?
269: const isOrg = orgs.some((o) => o.slug === parsed.projectSlug);
270: if (isOrg) {
271: return { org: parsed.projectSlug, project: undefined };
272: }
273:
274: // Truly not found — treat as the name for a new project to create.
275: // Org will be resolved later by init preflight before the workflow starts.
276: log.info(
277: `No existing project "${parsed.projectSlug}" found — will create a new project with this name.`
278: );
279: return { org: undefined, project: parsed.projectSlug };
280: }
281: ...
Found 19 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts:
Line 63: customUsage: [USAGE],
/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/lib/list-command.ts:
Line 674: * - An optional positional `target` argument
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/resolve.ts:
Line 145: * Parse a dashboard reference and optional target from array positional args.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts:
Line 8: * Supports two optional positionals with smart disambiguation:
Line 98: * Classify and separate two optional positional args into a target and a directory.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 13: import type { CommandExample } from "./command.js";
Line 62: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
80: {
81: long: "--help",
82: description: "Show help for a command",
83: },
84: {
85: long: "--version",
86: description: "Show version",
87: },
88: ];
89:
90: /**
91: * Generate the commands list dynamically from Stricli's route structure.
92: * This ensures help text stays in sync with actual registered commands.
93: */
94: function generateCommands(): HelpCommand[] {
95: // Cast to our introspection types — Stricli's generic types are compatible
96: const routeMap = routes as unknown as RouteMap;
97: const entries = routeMap.getAllEntries();
98:
99: return entries
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible ...
Found 52 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 95: kind: "tuple" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: Line 218: kind: "tuple" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 223: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/upload.ts: Line 231: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/resolve.ts: Line 126: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/inject.ts: Line 80: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/snapshots/upload.ts: Line 354: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/snapshots/diff.ts: Line 246: kind: ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 496: default: false,
Line 501: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 142: default: false,
Line 148: default: DEFAULT_PERIOD,
Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging
Line 167: default: "newest",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/log/view.ts:
Line 290: default: {
Line 524: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 238: default: String(LIST_DEFAULT_LIMIT),
Line 250: default: "date" as const,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/log/list.ts:
Line 743: default: "100", // Logs are high-volume; 25 is too stingy for debugging
Line 769: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
ripgrep execution failed
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist</path> <type>directory</type> <entries> index.cjs index.d.cts index.d.ts index.js (4 entries) </entries>
Found 23 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 93: interface DocumentationKeywords {
Line 110: interface DocumentationHeaders {
Line 145: interface DocumentationBriefs {
Line 147: * Documentation brief to be included alongside `--help` flag in help text.
Line 153: * Documentation brief to be included alongside `--helpAll` flag in help text.
Line 159: * Documentation brief to be included alongside `--version` flag in help text.
Line 165: * Documentation brief to be included alongside `--` escape sequence in help text. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path> <type>file</type> <content> 1390: * - `false`: `"false"`, `"f"`, `"no"`, `"n"`, `"off"`, `"0"` 1391: * 1392: * Parsers are only executed when an input is provided, 1393: * so the empty string is treated as a truthy value (i.e. a flag that is present but has no value is treated as `true`). 1394: */ 1395: declare const looseBooleanParser: (input: string) => boolean; 1396: 1397: /** 1398: * Creates an input parser that checks if the input string is found in a list of choices. 1399: */ 1400: declare function buildChoiceParser<T extends string>(choices: readonly T[]): InputParser<T>; 1401: 1402: /** 1403: * Parses input strings as numbers. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands</path> <type>directory</type> <entries> agent-conversation.md alert.md api.md auth.md build.md cli.md code-mappings.md dart-symbol-map.md dashboard.md debug-files.md docs.md event.md explore.md feedback.md index.md info.md init.md issue.md local.md log.md monitor.md org.md platform.md proguard.md project.md react-native.md release.md replay.md repo.md schema.md snapshots.md sourcemap.md span.md status.md team.md trace.md trial.md (37 entries) </entries>
<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 } 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: ...
> sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-parser.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-parser.ts Generated ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help --json agent-conversation list
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, ...
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 ...
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
diff --git a/apps/cli-docs/src/fragments/commands/agent-conversation.md b/apps/cli-docs/src/fragments/commands/agent-conversation.md index 3fa952c15..e69de29bb 100644 --- a/apps/cli-docs/src/fragments/commands/agent-conversation.md +++ b/apps/cli-docs/src/fragments/commands/agent-conversation.md @@ -1,36 +0,0 @@ - - - -## Examples - -### List conversations - -```bash -# List recent agent conversations -sentry agent-conversation list - -# Explicit organization -sentry agent-conversation list my-org - -# Show more, last 24 hours -sentry agent-conversation list --limit 50 --period 24h - -# Filter conversations -sentry agent-conversation list -q "has:errors" - -# Paginate through results -sentry agent-conversation list my-org -c next -``` - -### View a conversation transcript - -```bash -# View full transcript (organization auto-detected) -sentry agent-conversation view conv-123 - -# Explicit organization -sentry agent-conversation view my-org/conv-123 - -# JSON output -sentry ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs --import ./script/require-shim.mjs -e 'import { routes } from "./src/app.ts"; const walk=(m,p=[])=>{for(const e of m.getAllEntries()){const t=e.target; const path=[...p,e.name.original]; if("getAllEntries" in t) walk(t,path); else {const pos=t.parameters?.positional; if(pos?.kind==="tuple") pos.parameters.forEach((x,i)=>{if(x.default!==undefined) console.log(path.join(" "),i,x.default,x.optional)})}}}; walk(routes);'
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
130: const ctx = createTestContext();
131: const cases: Array<{
132: args: string[];
133: expected: boolean;
134: }> = [
135: { args: ["init", "-y"], expected: false },
136: { args: ["init", "-n"], expected: false },
137: { args: ["init", "--yes=false"], expected: true },
138: { args: ["data", "-n", "10"], expected: true },
139: { args: ["data", "-y", "2"], expected: true },
140: ];
141:
142: try {
143: for (const testCase of cases) {
144: await run(app, testCase.args, ctx as TestContext);
145: expect(promptStates.at(-1)).toBe(testCase.expected);
146: }
147: } finally {
148: setInteractivePromptsAllowed(true);
149: }
150: });
151:
152: describe("buildCommand", () => {
153: test("builds a valid command object", () => {
154: const command = buildCommand({
155: auth: false,
156: docs: { ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 1795: function wrapVariadicParameter(text) {
Line 1839: positionalUsage = [wrapVariadicParameter(positional.parameter.placeholder ?? "args")];
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1772: function hasDefault(flag) {
1773: return "default" in flag && typeof flag.default !== "undefined";
1774: }
1775: function isOptionalAtRuntime(flag) {
1776: return flag.optional ?? hasDefault(flag);
1777: }
1778:
1779: // src/parameter/formatting.ts
1780: function wrapRequiredFlag(text) {
1781: return `(${text})`;
1782: }
1783: function wrapOptionalFlag(text) {
1784: return `[${text}]`;
1785: }
1786: function wrapVariadicFlag(text) {
1787: return `${text}...`;
1788: }
1789: function wrapRequiredParameter(text) {
1790: return `<${text}>`;
1791: }
1792: function wrapOptionalParameter(text) {
1793: return `[<${text}>]`;
1794: }
1795: function wrapVariadicParameter(text) {
1796: return `<${text}>...`;
1797: }
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/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/list-command.ts</path>
<type>file</type>
<content>
500: * are async generators — non-streaming commands yield once and return.
501: */
502: type ListCommandFunction<
503: FLAGS extends BaseFlags,
504: ARGS extends BaseArgs,
505: CONTEXT extends CommandContext,
506: > = (
507: this: CONTEXT,
508: flags: FLAGS,
509: ...args: ARGS
510: // biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system
511: ) => AsyncGenerator<unknown, CommandReturn | void, undefined>;
512:
513: /**
514: * Options for controlling which flags {@link buildListCommand} auto-injects.
515: *
516: * By default, `buildListCommand` adds `--fresh`, `--cursor`, and their aliases
517: * (`-f`, `-c`). Use these options to opt out when a command has conflicts. ...
Found 6 matches /home/byk/Code/getsentry/cli-pr-1558/.github/workflows/eval-skill-fork.yml: Line 66: run: pnpm run generate:schema && pnpm run generate:docs /home/byk/Code/getsentry/cli-pr-1558/.github/workflows/ci.yml: Line 186: run: pnpm run generate:docs Line 188: run: pnpm run check:fragments Line 217: echo "::error::Generated files are out of date. Run 'pnpm run generate:docs' locally and commit the result." Line 638: run: pnpm run generate:schema && pnpm run generate:docs Line 774: run: pnpm run generate:schema && pnpm run generate:docs
<path>/home/byk/Code/getsentry/cli-pr-1558/.github/workflows/ci.yml</path>
<type>file</type>
<content>
165: # the auto-commit step can push regenerated docs back. Fork PRs leave
166: # `ref` empty so checkout defaults to GITHUB_REF (the pull_request
167: # merge SHA, always fetchable from the base repo with github.token).
168: ref: ${{ steps.token.outcome == 'success' && (github.head_ref || github.ref_name) || '' }}
169: - uses: pnpm/action-setup@v4
170: - uses: actions/setup-node@v6
171: with:
172: node-version: ${{ env.NODE_VERSION_22 }}
173: - uses: actions/cache@v5
174: id: cache
175: with:
176: path: |
177: node_modules
178: packages/*/node_modules
179: apps/*/node_modules
180: key: node-modules-${{ hashFiles('pnpm-lock.yaml', '.npmrc', 'packages/cli/patches/**') }}
181: - if: steps.cache.outputs.cache-hit != 'true'
182: ...
<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: ...
> sentry@0.45.0-dev.0 test /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run test:unit -- --run test/lib/command.test.ts test/lib/introspect.test.ts test/lib/introspect.property.test.ts test/script/generate-skill-markdown.test.ts test/commands/agent-conversation/list.test.ts --printConsoleTrace > sentry@0.45.0-dev.0 test:unit /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && vitest run test/lib test/commands test/types test/script --coverage -- --run test/lib/command.test.ts test/lib/introspect.test.ts test/lib/introspect.property.test.ts test/script/generate-skill-markdown.test.ts test/commands/agent-conversation/list.test.ts --printConsoleTrace > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 ...
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? {}).filter(([, flag]) => {
1800: if (flag.hidden) {
1801: return false;
1802: }
1803: if (args.config.onlyRequiredInUsageLine && isOptionalAtRuntime(flag)) {
1804: return false;
1805: }
1806: return true;
1807: }).map(([name, flag]) => {
1808: let displayName = args.config.caseStyle === "convert-camel-to-kebab" ? `--${convertCamelCaseToKebabCase(name)}` : `--${name}`;
1809: if (parameters.aliases && args.config.useAliasInUsageLine) {
1810: const aliases = Object.entries(parameters.aliases).filter((entry) => entry[1] === name);
1811: if (aliases.length === 1 && aliases[0]) {
1812: displayName = `-${aliases[0][0]}`;
1813: }
1814: }
1815: if (flag.kind === ...
Found 18 matches
/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
/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/commands/team/list.ts:
Line 22: type OrgListCommandDocs,
Line 59: const docs: ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/alert/issues/create.ts</path>
<type>file</type>
<content>
75: " --filter an action-filter condition (same shape as --condition)\n\n" +
76: "Match mode: --filter-match all|any controls how the action-filter\n" +
77: "conditions combine. Issue-alert triggers always evaluate as 'any-short'\n" +
78: "(they fire on a single error detector), so there is no trigger match flag.\n\n" +
79: "Examples:\n" +
80: " sentry alert issues create my-org/my-app --name 'New Issues' \\\n" +
81: ' --condition \'{"type":"first_seen_event","comparison":true,"conditionResult":true}\' \\\n' +
82: ' --action \'{"type":"email","data":{},"config":{"targetType":"team","targetIdentifier":"1"}}\'\n\n' +
83: " sentry alert issues create my-org/my-app --name 'High Priority' \\\n" +
84: ' --condition ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
65: * Resolve the default subcommand name for a route map, if configured.
66: *
67: * Hidden dispatcher routes (e.g. auth's `default`) map bare group examples
68: * onto the user-facing command they primarily document (login).
69: */
70: function findDefaultCommandName(routeMap: RouteMap): string | undefined {
71: if (!routeMap.getDefaultCommand) {
72: return;
73: }
74: const defaultCmd = routeMap.getDefaultCommand();
75: if (!defaultCmd) {
76: return;
77: }
78: for (const sub of routeMap.getAllEntries()) {
79: if (sub.target === defaultCmd) {
80: const name = sub.name.original;
81: // Auth uses a hidden "default" dispatcher; bare `sentry auth` examples
82: // document the login path. ...
Found 7 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts: Line 29: matchExampleToCommand, Line 395: const target = matchExampleToCommand( Line 417: async function loadCommandExamples( Line 488: const docExamples = await loadCommandExamples( Line 496: commands: extractRouteGroupCommands(target, routeName, docExamples), Line 500: const examples = docExamples.get(path) ?? []; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill-markdown.ts: Line 18: export function matchExampleToCommand(
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
345: * Initializes each path with an empty array in the examples map.
346: */
347: function collectCommandPaths(
348: tokens: Token[],
349: examples: Map<string, string[]>
350: ): string[] {
351: const paths: string[] = [];
352: for (const token of tokens) {
353: if (token.type !== "heading" || token.depth !== 3) {
354: continue;
355: }
356: const cmdPath = extractCommandPathFromHeading(token.text);
357: if (cmdPath) {
358: paths.push(cmdPath);
359: if (!examples.has(cmdPath)) {
360: examples.set(cmdPath, []);
361: }
362: }
363: }
364: return paths;
365: }
366:
367: /**
368: * Walk tokens sequentially and associate each bash code block with
369: * the appropriate command path — either by heading context or content matching. ...
No files found
Found 52 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 568: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
Line 679: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill-markdown.ts:
Line 5: /** Matches a generated command heading and stops before positional usage. */
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-sdk.ts:
Line 179: * Derive positional parameter info from the command's positional placeholder.
Line 181: * - No positional → null
Line 185: /** One entry of a tuple positional, mapped to its own SDK param. */
Line 194: const params = command.parameters?.positional;
Line 208: // joining them into one param made every multi-positional command unusable, because the
Line 323: positional: PositionalInfo,
Line 328: if (positional && ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
550: return parts.join(" - ");
551: }
552:
553: /**
554: * Get the visible, non-global flags for a command.
555: * Excludes hidden flags, help, and globally-injected flags.
556: */
557: function getVisibleFlags(cmd: CommandInfo): FlagInfo[] {
558: return cmd.flags.filter((f) => !(f.hidden || GLOBAL_FLAG_NAMES.has(f.name)));
559: }
560:
561: // ---------------------------------------------------------------------------
562: // Reference File Generation (full detail)
563: // ---------------------------------------------------------------------------
564:
565: /** Generate full documentation for a single command (used in reference files) */
566: function generateFullCommandDoc(cmd: CommandInfo): string {
567: const lines: string[] = [];
568: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
569: lines.push(`### ...
Found 3 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.");
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
585: platform,
586: });
587: teamSlug = fallback.teamSlug;
588: teamSource = fallback.teamSource;
589: projectDetails = fallback;
590: }
591:
592: const { project, dsn, url } = projectDetails;
593: return {
594: project,
595: orgSlug,
596: teamSlug,
597: teamSource,
598: requestedPlatform: platform,
599: dsn,
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
No files found
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
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 ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) .env.local not found. Continuing without it. .env.local not found. Continuing without it. > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
diff --git a/packages/cli/test/commands/agent-conversation/list.test.ts b/packages/cli/test/commands/agent-conversation/list.test.ts
index 21a26bd6c..e080697cc 100644
--- a/packages/cli/test/commands/agent-conversation/list.test.ts
+++ b/packages/cli/test/commands/agent-conversation/list.test.ts
@@ -280,6 +280,19 @@ describe("listCommand.func", () => {
);
});
+ test("uses the canonical optional-org usage in resolution errors", async () => {
+ resolveOrgSpy.mockResolvedValue(null);
+
+ const { context } = createMockContext();
+ const func = await listCommand.loader();
+
+ await expect(
+ func.call(context, HUMAN_FLAGS, undefined)
+ ).rejects.toMatchObject({
+ command: "sentry agent-conversation list [<org>]",
+ });
+ });
+
test("yields CommandOutput with conversation data (JSON)", async () => {
listConversationsSpy.mockResolvedValue({
data: sampleConversations,
diff --git a/packages/cli/test/lib/command.test.ts ...
Found 9 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/widget/index.ts: Line 47: "Row-filling examples:\n" + /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 111: examples: string[]; Line 289: examples: string[] = [] Line 304: examples: cmd.__examples?.length /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/local.ts: Line 270: * Output examples: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts: Line 520: examples: string[], Line 542: examples: string[],
Found 4 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 107: * `customUsage` is present, its first line is the canonical signature suffix; Line 464: const primaryUsage = docs.customUsage?.[0]; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts: Line 609: customUsage: ["[<org>/]<name>:<platform>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 63: customUsage: [USAGE],
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 496: default: false, Line 501: default: false, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 142: default: false, Line 148: default: DEFAULT_PERIOD, Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging Line 167: default: "newest", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 238: default: String(LIST_DEFAULT_LIMIT), Line 250: default: "date" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts: Line 43: default: SENTRY_STATUS_PAGE_URL, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 587: default: String(LIST_DEFAULT_LIMIT), Line 600: default: ...
Found 50 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 95: kind: "tuple" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: Line 218: kind: "tuple" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 223: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/upload.ts: Line 231: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/resolve.ts: Line 126: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/inject.ts: Line 80: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/snapshots/upload.ts: Line 354: kind: "tuple", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/snapshots/diff.ts: Line 246: kind: ...
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 496: default: false, Line 501: default: false, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 142: default: false, Line 148: default: DEFAULT_PERIOD, Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging Line 167: default: "newest", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 238: default: String(LIST_DEFAULT_LIMIT), Line 250: default: "date" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/view.ts: Line 216: default: false, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/utils.ts: Line 81: * @param base - Base command prefix (default: "sentry issue") Line 583: /** Base command prefix for error hints ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 465: function parseProjectSpecs(rawSpecs: readonly string[]): {
Line 658: const { explicitOrg, parsed } = parseProjectSpecs(args);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
450: }
451:
452: const rawName = rawSpec.slice(0, separatorIndex);
453: const platform = parseProjectPlatform(
454: rawName,
455: rawSpec.slice(separatorIndex + 1)
456: );
457: return parseProjectName(rawName, platform);
458: }
459:
460: /**
461: * Parse one or more `[<org>/]<name>:<platform>` pairs, then require explicit
462: * org prefixes to agree. A lone positional with no colon at all gets a
463: * friendlier "platform is required" error instead of the generic syntax error.
464: */
465: function parseProjectSpecs(rawSpecs: readonly string[]): {
466: explicitOrg?: string;
467: parsed: ParsedProjectSpec[];
468: } {
469: if (rawSpecs.length === 0) {
470: throw new ContextError("Project specification", USAGE_HINT, []);
471: }
472:
473: if (rawSpecs.length === 1 && !rawSpecs[0]?.includes(":")) {
474: throw new ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts</path>
<type>file</type>
<content>
300: "install the SDK, and configure Sentry.\n\n" +
301: "Supports org/project syntax and a directory positional. Path-like\n" +
302: "arguments (starting with . / ~) are treated as the directory;\n" +
303: "everything else is treated as the target.\n\n" +
304: "Examples:\n" +
305: " sentry init\n" +
306: " sentry init acme/\n" +
307: " sentry init acme/my-app\n" +
308: " sentry init my-app\n" +
309: " sentry init acme/my-app ./my-project\n" +
310: " sentry init ./my-project",
311: },
312: parameters: {
313: positional: {
314: kind: "tuple",
315: parameters: [
316: {
317: placeholder: "target",
318: brief: "<org>/<project>, <org>/, <project>, or a directory path",
319: parse: String,
320: optional: true,
321: },
322: ...
Found 21 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 893: // introspect.ts reads this to populate CommandInfo.jsonFields for help
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 55: * reads it to populate {@link CommandInfo.jsonFields}.
Line 102: export type CommandInfo = {
Line 131: commands: CommandInfo[];
Line 139: | { kind: "command"; info: CommandInfo }
Line 280: * Build a {@link CommandInfo} from a Stricli Command.
Line 286: export function buildCommandInfo(
Line 290: ): CommandInfo {
Line 324: ): CommandInfo[] {
Line 325: const commands: CommandInfo[] = [];
Line 336: commands.push(buildCommandInfo(subTarget, path, examples));
Line 378: commands: [buildCommandInfo(target, path)],
Line 453: info: buildCommandInfo(target, `sentry ${entry.name.original}`),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 21: type ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
675: }
676: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
677: syntax += " <value>";
678: } else if (flag.variadic) {
679: syntax += " <value>...";
680: }
681: const parts = [syntax];
682: if (flag.brief) {
683: parts.push(flag.brief);
684: }
685: if (flag.default !== undefined && flag.kind !== "boolean") {
686: parts.push(`(default: ${JSON.stringify(flag.default)})`);
687: }
688: return parts.join(" — ");
689: }
690:
691: /**
692: * Format a CommandInfo as human-readable text.
693: */
694: function formatCommandHuman(cmd: CommandInfo): string {
695: const lines: string[] = [];
696: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
697: lines.push(signature);
698: lines.push("");
699: lines.push(` ${cmd.brief}`);
700:
701: const visibleFlags = cmd.flags.filter((f) => ...
<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/script/check-fragments.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Validate doc fragment files.
4: *
5: * Ensures fragment files stay consistent with the CLI route tree:
6: * 1. Every route has a corresponding fragment file (+ index.md)
7: * 2. Every fragment file corresponds to an existing route (or is index.md)
8: * 3. Fragment files don't accidentally contain frontmatter or the generated marker
9: * 4. Top-level fragments (e.g., configuration.md) exist
10: * 5. Fragment content covers all subcommands in a route (warnings only)
11: *
12: * Usage:
13: * tsx script/check-fragments.ts # Warnings for missing subcommands
14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
15: */
16:
17: import { mkdirSync, readdirSync } from "node:fs";
18: import { access, readFile, writeFile } from "node:fs/promises";
19: import type { RouteInfo, RouteMap ...
Found 11 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md: Line 2: name: sentry-cli-agent-conversation Line 14: ### `sentry agent-conversation list [<org>]` Line 51: sentry agent-conversation list Line 54: sentry agent-conversation list my-org Line 57: sentry agent-conversation list --limit 50 --period 24h Line 60: sentry agent-conversation list -q "has:errors" Line 63: sentry agent-conversation list my-org -c next Line 66: ### `sentry agent-conversation view [<org>/]<conversation-id>` Line 77: sentry agent-conversation view conv-123 Line 80: sentry agent-conversation view my-org/conv-123 Line 83: sentry agent-conversation view my-org/conv-123 --json
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 ...
(no output)
<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: ...
(no output)
<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 5 matches /home/byk/Code/getsentry/cli-pr-1558/.lore.md: Line 26: * **check-fragments.ts: validates fragment files against actual route names**: \`script/check-fragments.ts\`: validates fragment files against actual route names (Check 1-4) AND validates subcommand coverage within fragments (Check 5). Check 5: for each route with >1 command, verifies fragment mentions each subcommand via a heading (outside fenced code blocks) or \`sentry \<route> \<subcommand>\` code reference. Default commands handled: if fragment contains bare \`sentry \<route>\`, the default command is covered. Default commands detected from route map (\`defaultCommand\` field in route index files). Fenced code block content stripped before heading scan to avoid false positives from bash comments. Warnings by default; \`--strict\` makes them errors. Run via \`pnpm run check:fragments\`. CI \`check-generated\` job triggers when \`changes.outputs.skill == ...
<path>/home/byk/Code/getsentry/cli-pr-1558/.github/workflows/ci.yml</path>
<type>file</type>
<content>
155: # Fork PRs don't have access to secrets, so this step is skipped
156: if: github.event.pull_request.head.repo.full_name == github.repository || github.event_name != 'pull_request'
157: uses: actions/create-github-app-token@v3
158: with:
159: app-id: ${{ vars.SENTRY_RELEASE_BOT_CLIENT_ID }}
160: private-key: ${{ secrets.SENTRY_RELEASE_BOT_PRIVATE_KEY }}
161: - uses: actions/checkout@v6
162: with:
163: token: ${{ steps.token.outputs.token || github.token }}
164: # Same-repo PRs (token step succeeded): check out the branch head so
165: # the auto-commit step can push regenerated docs back. Fork PRs leave
166: # `ref` empty so checkout defaults to GITHUB_REF (the pull_request
167: # merge SHA, always fetchable from the base repo with github.token). ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
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.
419: */
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
69:/** A single positional parameter with optional brief and placeholder */
73: optional?: boolean;
80: optional: boolean;
88: optional?: boolean;
119: optional: boolean;
192:export function getPositionalString(params?: PositionalParams): string {
215: * the parameter is optional. Used by documentation generators to build
221:export function extractPositionals(
232: optional: p.optional ?? false,
241: optional: true,
267: optional: def.optional ?? def.kind === "boolean",
295: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
296: positionals: extractPositionals(cmd.parameters.positional),
146:function formatPositionalsTable(positionals: PositionalInfo[]): string {
192: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
193: lines.push(`### \`${signature}\``);
200: lines.push(formatPositionalsTable(cmd.positionals));
101: customUsage: ["[<org>]"],
117: positional: {
124: optional: true,
139: optional: true,
No files found
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts: Line 186: customUsage: ["<name>:<kind>..."],
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
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 the primary custom usage line for introspection", () => {
182: const command = buildCommand<Record<string, never>, string[]>({
183: auth: false,
184: docs: {
185: brief: "Create things",
186: customUsage: ["<name>:<kind>..."],
187: },
188: parameters: {
189: positional: {
190: ...
No files found
ripgrep execution failed
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: lines.push("|----------|-------------|");
157: for (const p of positionals) {
158: const syntax = p.optional ? `[<${p.placeholder}>]` : ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts:
Line 163: const leaf = subPath.split(" ").at(-1) ?? subPath;
Line 197: * Build a map of route name → RouteInfo for routes with multiple subcommands.
Line 270: const leaf = sub.split(" ").at(-1) ?? sub;
<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 ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help agent-conversation view --json
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"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",
...
0 36 apps/cli-docs/src/fragments/commands/agent-conversation.md 21 21 packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md 3 3 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-...
No files found
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation view --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation view [<org>/]<conversation-id> sentry agent-conversation view --help View the full transcript of an agent conversation. The org is optional and auto-detected from your project context when omitted. Prefix the ID with an org slug to target a specific org. ...
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 ...
Found 25 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 67: * Hidden dispatcher routes (e.g. auth's `default`) map bare group examples
Line 81: // Auth uses a hidden "default" dispatcher; bare `sentry auth` examples
Line 345: * Initializes each path with an empty array in the examples map.
Line 349: examples: Map<string, string[]>
Line 359: if (!examples.has(cmdPath)) {
Line 360: examples.set(cmdPath, []);
Line 376: examples: Map<string, string[]>;
Line 380: const { commandPaths, commandGroup, examples, defaultCommandPath } = context;
Line 392: if (currentCmd && examples.has(currentCmd)) {
Line 393: appendExample(examples, currentCmd, code);
Line 402: appendExample(examples, target, code);
Line 409: * Load examples for a specific command group from docs using the `marked`
Line 427: const examples = new Map<string, string[]>();
Line 428: const ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
330: }
331:
332: /** Append a code block to a map entry, creating the array if needed */
333: function appendExample(
334: map: Map<string, string[]>,
335: key: string,
336: code: string
337: ): void {
338: const list = map.get(key) ?? [];
339: list.push(code);
340: map.set(key, list);
341: }
342:
343: /**
344: * Collect all command paths from `### \`sentry ...\`` headings in a token list.
345: * Initializes each path with an empty array in the examples map.
346: */
347: function collectCommandPaths(
348: tokens: Token[],
349: examples: Map<string, string[]>
350: ): string[] {
351: const paths: string[] = [];
352: for (const token of tokens) {
353: if (token.type !== "heading" || token.depth !== 3) {
354: continue;
355: }
356: const cmdPath = extractCommandPathFromHeading(token.text);
357: if (cmdPath) {
358: ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md index 60f3eabf6..045fa4376 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md @@ -11,7 +11,7 @@ requires: Manage Sentry alert rules -### `sentry alert issues list <org/project>` +### `sentry alert issues list [<org/project>]` List issue alert rules @@ -49,7 +49,7 @@ sentry alert issues view my-org/my-project/12345 sentry alert issues view my-org/my-project/"Error Spike" ``` -### `sentry alert issues create <target>` +### `sentry alert issues create [<target>]` Create an issue alert rule @@ -112,7 +112,7 @@ Edit an issue alert rule sentry alert issues edit my-org/my-project/12345 --name "Prod Error Spike" --status disabled ``` -### `sentry alert metrics list <target>` +### `sentry alert metrics list ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path>
<type>file</type>
<content>
500: * are async generators — non-streaming commands yield once and return.
501: */
502: type ListCommandFunction<
503: FLAGS extends BaseFlags,
504: ARGS extends BaseArgs,
505: CONTEXT extends CommandContext,
506: > = (
507: this: CONTEXT,
508: flags: FLAGS,
509: ...args: ARGS
510: // biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system
511: ) => AsyncGenerator<unknown, CommandReturn | void, undefined>;
512:
513: /**
514: * Options for controlling which flags {@link buildListCommand} auto-injects.
515: *
516: * By default, `buildListCommand` adds `--fresh`, `--cursor`, and their aliases
517: * (`-f`, `-c`). Use these options to opt out when a command has conflicts. ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
1 subcommand coverage warning(s):
⚠ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
All 37 command fragment files valid (36 routes + index)
All 1 top-level fragment(s) valid
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path> <type>file</type> <content> 668: /** 669: * Build a complete Stricli command whose entire `func` body delegates to 670: * `dispatchOrgScopedList`. 671: * 672: * This covers the team and repo list commands, where all runtime behaviour is 673: * encapsulated in the shared org-list framework. The resulting command has: 674: * - An optional positional `target` argument 675: * - `--limit` / `-n`, `--json`, `--fields`, `--cursor` / `-c` flags 676: * - A `func` that calls `parseOrgProjectArg` then `dispatchOrgScopedList` 677: * 678: * Rendering is handled automatically via `OutputConfig`: 679: * - JSON mode produces paginated envelopes or flat arrays 680: * - Human mode uses the config's `displayTable` function 681: * 682: * @param config - The `OrgListConfig` that drives fetching and display 683: * @param docs - Brief and optional full description for `--help` 684: * @param routeName - ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/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: ...
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 154: readonly docs: CommandDocumentation; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts: Line 552: readonly docs: CommandDocumentation; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts: Line 335: readonly docs: CommandDocumentation;
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 165: * buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts:
Line 405: return buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts:
Line 618: return buildCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/output.ts:
Line 10: * buildCommand({
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/alert/issues/create.ts</path>
<type>file</type>
<content>
75: " --filter an action-filter condition (same shape as --condition)\n\n" +
76: "Match mode: --filter-match all|any controls how the action-filter\n" +
77: "conditions combine. Issue-alert triggers always evaluate as 'any-short'\n" +
78: "(they fire on a single error detector), so there is no trigger match flag.\n\n" +
79: "Examples:\n" +
80: " sentry alert issues create my-org/my-app --name 'New Issues' \\\n" +
81: ' --condition \'{"type":"first_seen_event","comparison":true,"conditionResult":true}\' \\\n' +
82: ' --action \'{"type":"email","data":{},"config":{"targetType":"team","targetIdentifier":"1"}}\'\n\n' +
83: " sentry alert issues create my-org/my-app --name 'High Priority' \\\n" +
84: ' --condition ...
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>
1200: // Users often type short IDs in uppercase (e.g., "EASI-API-3Y4") which
1201: // produces an uppercase project slug that would fail API lookups (CLI-C8).
1202: return {
1203: type: "project-search",
1204: projectSlug: projectSlug.toLowerCase(),
1205: suffix,
1206: };
1207: }
1208:
1209: /**
1210: * Parse a single positional arg that may be a plain hex ID or a slash-separated
1211: * `org/project/id` pattern. ...
Found 31 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/schema.md: Line 18: | `[<resource...>]` | Resource name and optional operation | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/local.md: Line 33: | `[<command...>]` | Command to run | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/trace.md: Line 39: | `[<org/project/trace-id...>]` | [<org>/<project>/]<trace-id> - Target (optional) and trace ID (required) | Line 58: | `[<org/project/trace-id...>]` | [<org>/[<project>/]]<trace-id> - Optional org/project and required trace ID | /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/span.md: Line 18: | `[<org/project/trace-id...>]` | [<org>/<project>] or [<org>/<project>/]<trace-id> | Line 39: | `[<trace-id/span-id...>]` | [<org>/<project>/]<trace-id> ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project (Showing lines 8-29 of 145. Use offset=30 to continue.) </content>
--- name: sentry-cli-agent-conversation version: 0.45.0-dev.0 description: List and view agent conversations requires: bins: ["sentry"] auth: true --- # Agent-conversation Commands List and view agent conversations ### `sentry agent-conversation list [<org>]` List recent agent conversations **Flags:** - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` - `-q, --query <value> - Search query` - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` **JSON Fields** (use `--json --fields` to select specific fields): | Field | Type | Description | |-------|------|-------------| | `conversationId` | string | | | `title` | string \| null | | | `flow` | array | | | `errors` | number | | | `llmCalls` | number | | | `toolCalls` | number | | | ...
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 81: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: Line 202: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/index.ts: Line 12: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 470: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 102: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 201: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/index.ts: Line 21: fullDescription: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/team/list.ts: Line 61: ...
<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 ...
No files found
> sentry@0.45.0-dev.0 generate:command-docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-command-docs.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-command-docs.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated 36 command doc pages + ../../apps/cli-docs/src/content/docs/commands/index.md + ../../apps/cli-docs/src/content/docs/configuration.md
<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: ...
<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: ...
No files found
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 211: async function loadDoc(relativePath: string): Promise<string | null> {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
190: while (match !== null) {
191: const lang = match[1] || "";
192: const code = match[2].trim();
193: if (!language || lang === language) {
194: blocks.push({ code, lang });
195: }
196: match = pattern.exec(markdown);
197: }
198: return blocks;
199: }
200:
201: /** Escape special regex characters in a string */
202: function escapeRegex(str: string): string {
203: return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
204: }
205:
206: // ---------------------------------------------------------------------------
207: // Documentation Loading
208: // ---------------------------------------------------------------------------
209:
210: /** Load and parse a documentation file */
211: async function loadDoc(relativePath: string): Promise<string | null> {
212: const fullPath = `${DOCS_PATH}/${relativePath}`;
213: const exists = await ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
580: }
581: log.debug("403 on team-based flow — falling back to org-scoped endpoint");
582: const fallback = await createProjectWithAutoTeamFallback({
583: orgSlug,
584: name,
585: platform,
586: });
587: teamSlug = fallback.teamSlug;
588: teamSource = fallback.teamSource;
589: projectDetails = fallback;
590: }
591:
592: const { project, dsn, url } = projectDetails;
593: return {
594: project,
595: orgSlug,
596: teamSlug,
597: teamSource,
598: requestedPlatform: platform,
599: dsn,
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts:
Line 310: * docs: { brief: "Delete a widget" },
Line 328: export function buildDeleteCommand<
Line 335: readonly docs: CommandDocumentation;
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
<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 ...
No files found
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 286: export function buildCommandInfo(
Line 336: commands.push(buildCommandInfo(subTarget, path, examples));
Line 378: commands: [buildCommandInfo(target, path)],
Line 453: info: buildCommandInfo(target, `sentry ${entry.name.original}`),
<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.property.test.ts</path>
<type>file</type>
<content>
135: );
136: });
137: });
138:
139: describe("property: getPositionalString", () => {
140: test("tuple always produces angle-bracket placeholders", () => {
141: fcAssert(
142: property(
143: array(
144: record({
145: placeholder: oneof(string(), constantFrom(undefined)),
146: optional: boolean(),
147: })
148: ),
149: (params) => {
150: const result = getPositionalString({
151: kind: "tuple",
152: parameters: params,
153: });
154: if (params.length > 0) {
155: expect(result).toContain("<");
156: expect(result).toContain(">");
157: }
158:
159: for (const [index, parameter] of params.entries()) {
160: const placeholder = parameter.placeholder ?? ...
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts: Line 51: "# View full transcript (organization auto-detected)\nsentry agent-conversation view conv-123", Line 57: "**Examples:**", Line 60: "# View full transcript (organization auto-detected)",
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 ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts event send --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry event send [--dsn value] [--message value]... [--message-arg value]... [--level debug|info|warning|error|fatal] [--release value] [--dist value] [--env value] [--platform value] [--tag value]... [--extra value]... [--user value]... [--fingerprint value]... [--timestamp value] [--no-environ] [--logfile value] [--with-categories] [--raw] [--json] [--fields value] <args>... sentry event send --help Send a Sentry event to the ingest pipeline using DSN-based authentication. No login required — provide a DSN via --dsn or the SENTRY_DSN environment variable. ...
<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" ...
fatal: path 'apps/cli-docs/src/content/docs/commands/project.md' exists on disk, but not in 'HEAD'
fatal: path 'apps/cli-docs/src/content/docs/commands/schema.md' exists on disk, but not in 'HEAD'
157: const placeholder = `\`<${p.placeholder}>\``;
No files found
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts: Line 211: description: "Select an organization explicitly", Line 225: description: "Select an organization explicitly",
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
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 the primary custom usage line for introspection", () => {
182: const command = buildCommand<Record<string, never>, string[]>({
183: auth: false,
184: docs: {
185: brief: "Create things",
186: customUsage: ["<name>:<kind>..."],
187: },
188: parameters: {
189: positional: {
190: kind: "array",
191: parameter: { brief: "Name and kind pairs", parse: String },
192: },
193: },
194: async *func() {
195: yield null;
196: },
197: });
198:
199: expect(
200: (command as unknown ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts agent-conversation list --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. ...
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 465: function parseProjectSpecs(rawSpecs: readonly string[]): {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
450: }
451:
452: const rawName = rawSpec.slice(0, separatorIndex);
453: const platform = parseProjectPlatform(
454: rawName,
455: rawSpec.slice(separatorIndex + 1)
456: );
457: return parseProjectName(rawName, platform);
458: }
459:
460: /**
461: * Parse one or more `[<org>/]<name>:<platform>` pairs, then require explicit
462: * org prefixes to agree. A lone positional with no colon at all gets a
463: * friendlier "platform is required" error instead of the generic syntax error.
464: */
465: function parseProjectSpecs(rawSpecs: readonly string[]): {
466: explicitOrg?: string;
467: parsed: ParsedProjectSpec[];
468: } {
469: if (rawSpecs.length === 0) {
470: throw new ContextError("Project specification", USAGE_HINT, []);
471: }
472:
473: if (rawSpecs.length === 1 && !rawSpecs[0]?.includes(":")) {
474: throw new ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
520: const aOrder = aIndex === -1 ? 999 : aIndex;
521: const bOrder = bIndex === -1 ? 999 : bIndex;
522: return aOrder - bOrder;
523: });
524: }
525:
526: // ---------------------------------------------------------------------------
527: // Markdown Formatting Helpers
528: // ---------------------------------------------------------------------------
529:
530: /** Format a flag for display in documentation */
531: function formatFlag(flag: FlagInfo, aliases: Record<string, string>): string {
532: const parts: string[] = [];
533: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
534: let syntax = `--${flag.name}`;
535: if (alias) {
536: syntax = `-${alias}, ${syntax}`;
537: }
538: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
539: syntax += " <value>";
540: } else if ...
Found 8 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 211: async function loadDoc(relativePath: string): Promise<string | null> {
Line 421: const docContent = await loadDoc(`commands/${commandGroup}.md`);
Line 447: const content = await loadDoc("commands/index.md");
Line 466: return await loadDoc("agent-guidance.md");
Line 474: * Walk the route tree and extract command information with doc examples.
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>
360: examples.set(cmdPath, []);
361: }
362: }
363: }
364: return paths;
365: }
366:
367: /**
368: * Walk tokens sequentially and associate each bash code block with
369: * the appropriate command path — either by heading context or content matching.
370: */
371: function associateCodeBlocks(
372: tokens: Token[],
373: context: {
374: commandPaths: string[];
375: commandGroup: string;
376: examples: Map<string, string[]>;
377: defaultCommandPath?: string;
378: }
379: ): void {
380: const { commandPaths, commandGroup, examples, defaultCommandPath } = context;
381: const groupFallback = `sentry ${commandGroup}`;
382: let currentCmd: string | null = null;
383:
384: for (const token of tokens) {
385: if (token.type === "heading" && token.depth === 3) {
386: currentCmd = ...
Found 33 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 484: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 130: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts: Line 384: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 575: kind: "array", /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/send-envelope.ts: Line 26: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/schema.ts: Line 324: 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/replay/view.ts: Line ...
Found 5 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/schema.ts:
Line 70: if (resources.length === 0) {
Line 94: if (endpoints.length === 0) {
Line 242: if (matched.length === 0) {
Line 275: if (endpoints.length === 0) {
Line 339: if (results.length === 0) {
> sentry@0.45.0-dev.0 lint /home/byk/Code/getsentry/cli-pr-1558/packages/cli > biome check --no-errors-on-unmatched --error-on-warnings --max-diagnostics=none ./ Checked 1028 files in 55s. No fixes applied.
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
1 subcommand coverage warning(s):
⚠ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
All 37 command fragment files valid (36 routes + index)
All 1 top-level fragment(s) valid
diff --git a/packages/cli/test/commands/agent-conversation/list.test.ts b/packages/cli/test/commands/agent-conversation/list.test.ts
index 21a26bd6c..e080697cc 100644
--- a/packages/cli/test/commands/agent-conversation/list.test.ts
+++ b/packages/cli/test/commands/agent-conversation/list.test.ts
@@ -280,6 +280,19 @@ describe("listCommand.func", () => {
);
});
+ test("uses the canonical optional-org usage in resolution errors", async () => {
+ resolveOrgSpy.mockResolvedValue(null);
+
+ const { context } = createMockContext();
+ const func = await listCommand.loader();
+
+ await expect(
+ func.call(context, HUMAN_FLAGS, undefined)
+ ).rejects.toMatchObject({
+ command: "sentry agent-conversation list [<org>]",
+ });
+ });
+
test("yields CommandOutput with conversation data (JSON)", async () => {
listConversationsSpy.mockResolvedValue({
data: sampleConversations,
diff --git a/packages/cli/test/lib/command.test.ts ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
1: /**
2: * Route Tree Introspection
3: *
4: * Shared module for extracting structured metadata from Stricli's route tree.
5: * Used at runtime by `sentry help --json` and at build time by `generate-skill.ts`.
6: *
7: * While @stricli/core exports RouteMap and Command types, they require complex
8: * generic parameters (CommandContext) and don't export internal types like
9: * RouteMapEntry or FlagParameter. These simplified types are purpose-built
10: * for introspection and documentation generation.
11: */
12:
13: import type { CommandExample } from "./command.js";
14: import {
15: extractSchemaFields,
16: type SchemaFieldInfo,
17: } from "./formatters/output.js";
18: import { fuzzyMatch } from "./fuzzy.js";
19:
20: // ---------------------------------------------------------------------------
21: // Stricli Runtime Types (simplified for introspection)
22: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/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/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> (search across orgs) | 36: 37: **Options:** 38: 39: | Option | Description | 40: |--------|-------------| 41: | `-y, --yes` | Skip confirmation ...
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 ...
Found 2 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 63: customUsage: [USAGE],
No files found
.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.
{"path":"sentry help","usage":"<command...>","positionals":[{"placeholder":"command...","brief":"Command to get help for","optional":true}]}
{"path":"sentry build upload","usage":"<path...>","positionals":[{"placeholder":"path...","brief":"Path(s) to the build(s) to upload (APK, AAB, IPA, or XCArchive)","optional":true}]}
{"path":"sentry cli defaults","usage":"<key value...>","positionals":[{"placeholder":"key value...","brief":"Setting key and optional value","optional":true}]}
{"path":"sentry cli feedback","usage":"<message...>","positionals":[{"placeholder":"message...","brief":"Your feedback message","optional":true}]}
{"path":"sentry debug-files find","usage":"<id...>","positionals":[{"placeholder":"id...","brief":"Debug identifier(s) to search for","optional":true}]}
{"path":"sentry debug-files ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
380: * is skipped. The command's own `verbose` value is still used for log-level
381: * side-effects, and it is **not** stripped — the original func receives it as usual.
382: *
383: * Similarly, when a command already defines its own `json` flag (e.g. for
384: * custom brief text), the injected `JSON_FLAG` is skipped. `--fields` is
385: * always injected when `output: { human: ... }` regardless.
386: *
387: * Flag keys use kebab-case because Stricli uses the literal object key as
388: * the CLI flag name (e.g. `"log-level"` → `--log-level`). ...
Found 7 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 110: export type CommandDocumentation =
Line 148: type LocalCommandBuilderArguments<
Line 154: readonly docs: CommandDocumentation;
Line 421: docs: CommandDocumentation,
Line 424: ): CommandDocumentation {
Line 442: docs: CommandDocumentation
Line 461: docs: CommandDocumentation
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
.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.
{
"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",
"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"
},
{
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
95: const items =
96: fields && fields.length > 0
97: ? result.conversations.map((c) => filterFields(c, fields))
98: : result.conversations;
99:
100: const envelope: Record<string, unknown> = {
101: data: items,
102: hasMore: result.hasMore,
103: hasPrev: !!result.hasPrev,
104: };
105: if (result.nextCursor) {
106: envelope.nextCursor = result.nextCursor;
107: }
108: return envelope;
109: }
110:
111: export const listCommand = buildListCommand("agent-conversation", {
112: docs: {
113: brief: "List recent agent conversations",
114: fullDescription:
115: "List recent agent conversations from a Sentry organization.\n\n" +
116: "The organization is auto-detected when omitted.",
117: examples: [
118: {
119: description: "List recent agent conversations",
120: command: ...
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts:
Line 64: const POSITIONAL = {
Line 75: const USAGE_HINT = `sentry ${COMMAND_NAME} ${getPositionalString(POSITIONAL)}`;
Line 146: positional: POSITIONAL,
Line 173: throw new ContextError("Organization", USAGE_HINT);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
54: conversations: ConversationListItem[];
55: hasMore: boolean;
56: hasPrev?: boolean;
57: nextCursor?: string;
58: org: string;
59: };
60:
61: const COMMAND_NAME = "agent-conversation list";
62: const PAGINATION_KEY = "agent-conversation-list";
63: const DEFAULT_PERIOD = "7d";
64: const POSITIONAL = {
65: kind: "tuple",
66: parameters: [
67: {
68: placeholder: "org",
69: brief: "Organization slug",
70: parse: String,
71: optional: true,
72: },
73: ],
74: } as const;
75: const USAGE_HINT = `sentry ${COMMAND_NAME} ${getPositionalString(POSITIONAL)}`;
76:
77: function parseLimit(value: string): number {
78: return validateLimit(value, LIST_MIN_LIMIT, LIST_MAX_LIMIT);
79: }
80:
81: function formatListHuman(result: ConversationListResult): string {
(Showing lines 54-81 of 231. Use offset=82 to ...
...output truncated... Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_08479a205001Xh815AN1xB1wrS AGENT=1 npm_node_execpath=/home/byk/.volta/tools/image/node/24.16.0/bin/node SHLVL=0 HOME=/home/byk npm_package_json=/home/byk/Code/getsentry/cli-pr-1558/packages/cli/package.json npm_package_engines_node=>=20.0 SYSTEMD_EXEC_PID=3836710 OPENCODE_EXPERIMENTAL_PLAN_MODE=1 VOLTA_HOME=/home/byk/.volta _VOLTA_TOOL_RECURSION=1 LOGNAME=byk JOURNAL_STREAM=8:371688404 _=/home/byk/.volta/bin/pnpm MEMORY_PRESSURE_WATCH=/sys/fs/cgroup/system.slice/opencode.service/memory.pressure npm_config_registry=https://registry.npmjs.org/ npm_config_node_linker=isolated OPENCODE=1 SENTRY_ENABLED=1 npm_config_node_gyp=/home/byk/.opencode/server/opencode-server PATH=/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/.bin:/home/byk/.local/share/pnpm/.tools/pnpm/10.11.0_tmp_3945111/node_modules/pnpm/dist/node-gyp-bin:/home/byk/Code/getsentry/cli-pr-1558/node_modules/.bin:/home/byk...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
45: brief: string;
46: fullDescription?: string;
47: parameters: {
48: positional?: PositionalParams;
49: flags?: Record<string, FlagDef>;
50: aliases?: Record<string, string>;
51: };
52: /**
53: * JSON output schema attached by `buildCommand` when `output.schema` is set.
54: * Non-standard property — Stricli doesn't know about it, but introspection
55: * reads it to populate {@link CommandInfo.jsonFields}.
56: */
57: __jsonSchema?: import("valibot").GenericSchema;
58: /**
59: * Primary Stricli custom usage line, retained by `buildCommand` for
60: * introspection because Stricli does not expose it on the built command.
61: */
62: __primaryUsage?: string;
63: /** Canonical documentation examples retained by `buildCommand`. */
64: __examples?: readonly CommandExample[];
65: };
66:
67: /** Positional parameter definitions — ...
.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.
{"path":"sentry help","placeholder":"command"}
{"path":"sentry build upload","placeholder":"path"}
{"path":"sentry cli defaults","placeholder":"key value"}
{"path":"sentry cli feedback","placeholder":"message"}
{"path":"sentry debug-files find","placeholder":"id"}
{"path":"sentry debug-files upload","placeholder":"path"}
{"path":"sentry dashboard list","placeholder":"org/title-filter"}
{"path":"sentry dashboard view","placeholder":"org/project/dashboard"}
{"path":"sentry dashboard create","placeholder":"org/project/title"}
{"path":"sentry dashboard widget add","placeholder":"org/project/dashboard/title"}
{"path":"sentry dashboard widget edit","placeholder":"org/project/dashboard"}
{"path":"sentry dashboard widget delete","placeholder":"org/project/dashboard"}
{"path":"sentry dashboard ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: (Showing lines 1-30 of 145. Use offset=31 to continue.) </content>
No files found
No files found
No files found
0 36 apps/cli-docs/src/fragments/commands/agent-conversation.md 21 21 packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md 3 3 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
650: if (items.length === 2) {
651: return `${items[0]} or ${items[1]}`;
652: }
653: return `${items.slice(0, -1).join(", ")}, or ${items.at(-1)}`;
654: }
655:
656: // ---------------------------------------------------------------------------
657: // Human Rendering of Introspection Data
658: // ---------------------------------------------------------------------------
659:
660: /**
661: * Format a single flag for human display.
662: *
663: * @param flag - The flag info to format
664: * @param aliases - Command alias map for short flag lookup
665: * @returns Formatted flag string like "-l, --limit <value> - Max items"
666: */
667: function formatFlagHuman(
668: flag: import("./introspect.js").FlagInfo,
669: aliases: Record<string, string>
670: ): string {
671: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
672: let syntax ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
No files found
I’m completing the read-only review against the exact working-tree patch. I’ll trace the remaining generator and validation paths, then report only verified findings with current line evidence.
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
<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>
521: const bOrder = bIndex === -1 ? 999 : bIndex;
522: return aOrder - bOrder;
523: });
524: }
525:
526: // ---------------------------------------------------------------------------
527: // Markdown Formatting Helpers
528: // ---------------------------------------------------------------------------
529:
530: /** Format a flag for display in documentation */
531: function formatFlag(flag: FlagInfo, aliases: Record<string, string>): string {
532: const parts: string[] = [];
533: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
534: let syntax = `--${flag.name}`;
535: if (alias) {
536: syntax = `-${alias}, ${syntax}`;
537: }
538: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
539: syntax += " <value>";
540: } else if (flag.variadic) {
541: syntax += " <value>...";
542: }
543: ...
diff --git a/packages/cli/test/commands/agent-conversation/list.test.ts b/packages/cli/test/commands/agent-conversation/list.test.ts
index 21a26bd6c..e080697cc 100644
--- a/packages/cli/test/commands/agent-conversation/list.test.ts
+++ b/packages/cli/test/commands/agent-conversation/list.test.ts
@@ -280,6 +280,19 @@ describe("listCommand.func", () => {
);
});
+ test("uses the canonical optional-org usage in resolution errors", async () => {
+ resolveOrgSpy.mockResolvedValue(null);
+
+ const { context } = createMockContext();
+ const func = await listCommand.loader();
+
+ await expect(
+ func.call(context, HUMAN_FLAGS, undefined)
+ ).rejects.toMatchObject({
+ command: "sentry agent-conversation list [<org>]",
+ });
+ });
+
test("yields CommandOutput with conversation data (JSON)", async () => {
listConversationsSpy.mockResolvedValue({
data: sampleConversations,
diff --git a/packages/cli/test/lib/command.test.ts ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = docs.fullDescription ?? docs.brief;
434: return {
435: ...docs,
436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
437: };
438: }
439:
440: /** Convert extended command docs into native Stricli help documentation. */
441: function prepareNativeDocs(
442: docs: CommandDocumentation
443: ): StricliBuilderArgs<CommandContext>["docs"] {
444: const { examples, ...nativeDocs } = docs;
445: if (!examples?.length) {
446: return nativeDocs;
447: }
448:
449: const renderedExamples = examples
450: .map(({ description, command }) => ` ${command} # ${description}`)
451: .join("\n");
452: return {
453: ...nativeDocs,
454: fullDescription: `${nativeDocs.fullDescription ?? ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
620: }
621:
622: /**
623: * Strip injected flags from the raw Stricli-parsed flags object.
624: * Global flags we injected (tracked in `stripKeys` from
625: * {@link mergeGlobalFlags}) are removed. --fields is pre-parsed from
626: * comma-string to string[] when output: { human: ... }.
627: */
628: function cleanRawFlags(
629: raw: Record<string, unknown>
630: ): Record<string, unknown> {
631: const clean: Record<string, unknown> = {};
632: for (const [key, value] of Object.entries(raw)) {
633: if (stripKeys.has(key)) {
634: continue;
635: }
636: clean[key] = value;
637: }
638: if (outputConfig && typeof clean.fields === "string") {
639: clean.fields = parseFieldsList(clean.fields);
640: }
641: return clean;
642: }
643:
644: /**
645: * Write post-generator output: either the renderer's ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
820: }
821:
822: // Execution phase: core command logic, API calls, org/project resolution
823: const returned = await withTracing(
824: "exec",
825: "cli.command.exec",
826: async () => {
827: const generator = originalFunc.call(
828: this,
829: cleanFlags as FLAGS,
830: ...(args as unknown as ARGS)
831: );
832: let result = await generator.next();
833: while (!result.done) {
834: handleYieldedValue(stdout, result.value, cleanFlags, renderer);
835: result = await generator.next();
836: }
837: return result.value as CommandReturn | undefined;
838: }
839: );
840:
841: // Render phase: output finalization. ...
I’m completing the read-only review against the exact patch, including generated artifacts and edge-case regressions.
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path> <type>file</type> <content> 520: /** Skip injecting `--cursor` flag and `-c` alias (e.g., log list uses streaming). */ 521: noCursorFlag?: boolean; 522: /** Skip injecting `-f` alias for `--fresh` (e.g., log list uses `-f` for `--follow`). */ 523: noFreshAlias?: boolean; 524: }; 525: 526: /** 527: * Build a Stricli command for a list endpoint with automatic plural-alias 528: * interception and common flag injection. 529: * 530: * This is a drop-in replacement for `buildCommand` that: 531: * 1. Intercepts subcommand names passed through plural aliases 532: * 2. Auto-injects `--fresh` and `--cursor` flags (unless already defined) 533: * 3. Auto-injects `-f` and `-c` aliases (with opt-outs via `options`) 534: * 4. Auto-calls `applyFreshFlag(flags)` before the command function runs 535: * 536: * Commands that define their own `cursor` or `fresh` flags (e.g., with a 537: * custom ...
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 ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path> <type>file</type> <content> 130: * rendered after all yields are consumed. Hints live exclusively on 131: * the return value — never on individual yields. 132: */ 133: type SentryCommandFunction< 134: FLAGS extends BaseFlags, 135: ARGS extends BaseArgs, 136: CONTEXT extends CommandContext, 137: > = ( 138: this: CONTEXT, 139: flags: FLAGS, 140: ...args: ARGS 141: // biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system 142: ) => AsyncGenerator<unknown, CommandReturn | void, undefined>; 143: 144: /** 145: * Arguments for building a command with a local function. 146: * This is the subset of Stricli's CommandBuilderArguments that we support. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. */
100: readonly description: string;
101: /** Complete command line, including the `sentry` executable. */
102: readonly command: string;
103: };
104:
105: /**
106: * Native Stricli documentation plus metadata for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: /**
218: * Extract ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
295: return {
296: path,
297: brief: cmd.brief,
298: fullDescription: cmd.fullDescription,
299: flags: extractFlags(cmd.parameters.flags),
300: positional:
301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
302: positionals: extractPositionals(cmd.parameters.positional),
303: aliases: cmd.parameters.aliases ?? {},
304: examples: cmd.__examples?.length
305: ? cmd.__examples.map(
306: ({ description, command }) => `# ${description}\n${command}`
307: )
308: : examples,
309: jsonFields: jsonFields?.length ? jsonFields : undefined,
310: };
311: }
312:
313: /**
314: * Extract all visible subcommands from a route group.
315: *
316: * @param routeMap - The route map to introspect
317: * @param routeName - Parent route name (e.g. ...
184-// ---------------------------------------------------------------------------
185-
186-/**
187- * Build a positional parameter placeholder string from Stricli positional params.
188- *
189- * @param params - Stricli positional parameter definition
190- * @returns Human-readable placeholder like `<target>` or `<command...>`
191- */
192:export function getPositionalString(params?: PositionalParams): string {
193- if (!params) {
194- return "";
195- }
196-
197- if (params.kind === "tuple") {
198- return params.parameters
199- .map((p, i) => `<${p.placeholder ?? `arg${i}`}>`)
200- .join(" ");
--
213- *
214- * Returns one entry per positional, with placeholder, brief, and whether
215- * the parameter is optional. Used by documentation generators to build
216- * argument tables.
217- *
218- * @param params - Stricli positional parameter definition
219- * @returns Array of positional info objects
220- */
221:export function extractPositionals(
222- params?: ...
<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 ...
<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/src/lib/introspect.ts</path>
<type>file</type>
<content>
214: return "";
215: }
216:
217: /**
218: * Extract structured positional parameter metadata from a command.
219: *
220: * Returns one entry per positional, with placeholder, brief, and whether
221: * the parameter is optional. Used by documentation generators to build
222: * argument tables.
223: *
224: * @param params - Stricli positional parameter definition
225: * @returns Array of positional info objects
226: */
227: export function extractPositionals(
228: params?: PositionalParams
229: ): PositionalInfo[] {
230: if (!params) {
231: return [];
232: }
233:
234: if (params.kind === "tuple") {
235: return params.parameters.map((p, i) => ({
236: placeholder: p.placeholder ?? `arg${i}`,
237: brief: p.brief ?? "",
238: optional: p.optional ?? false,
239: }));
240: }
241:
242: if (params.kind === "array") {
243: ...
No files found
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_084a496f8001Z0KTWMCd7l2Gru
readonly output?: OutputConfig<any>;
/**
* Whether the command requires authentication. Defaults to `true`.
*
* When `true` (the default), the command throws `AuthError("not_authenticated")`
* before executing if no credentials exist at all (no token or refresh token
* in the DB or env vars). Expired tokens with a valid refresh token pass the
* guard — the API client handles silent refresh. The auto-auth middleware in
* `cli.ts` catches the error and triggers the login flow.
*
* Set to `false` for commands that intentionally work without a token
* (e.g. `auth login`, `auth logout`, `auth status`, `help`, `cli upgrade`).
*
* Set to `"dsn"` for commands that authenticate via a Sentry DSN instead of
* a Bearer token (e.g. `event send`). These commands skip
* the token guard and the `.sentryclirc` URL trust ...
<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/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
I’m checking the array-positional and help-rendering edge cases now. The patch changes shared metadata, so a command outside agent-conversation can expose a regression even when the focused tests pass.
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
@@ -37,126 +37,138 @@ import {
numberParser as stricliNumberParser,
} from "@stricli/core";
import type { Writer } from "../types/index.js";
import { appendCacheHint } from "./cache-hint.js";
import { getAuthConfig } from "./db/auth.js";
import { getEnv } from "./env.js";
import { AuthError, CliError, OutputError } from "./errors.js";
import { warning } from "./formatters/colors.js";
import { parseFieldsList } from "./formatters/json.js";
import {
ClearScreen,
CommandOutput,
type CommandReturn,
extractSchemaFields,
formatSchemaForHelp,
type HumanRenderer,
type OutputConfig,
renderCommandOutput,
resolveRenderer,
writeFooter,
} from "./formatters/output.js";
import { isPlainOutput } from "./formatters/plain-detect.js";
import { GLOBAL_FLAGS } from ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: lines.push("|----------|-------------|");
157: for (const p of positionals) {
158: const syntax = p.optional ? `[<${p.placeholder}>]` : `<${p.placeholder}>`;
159: const placeholder = `\`${syntax}\``;
160: lines.push(`| ${placeholder} | ${escapeAngleBrackets(p.brief)} |`);
161: }
162: return lines.join("\n");
163: }
164:
165: /** Format flags as a markdown options table */
166: function formatFlagsTable(
167: flags: FlagInfo[],
168: aliases: Record<string, string>
169: ): string ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
120: * each yielded value and renders it through the output config.
121: *
122: * - **Non-streaming**: yield a single `CommandOutput<T>`, optionally
123: * return `{ hint }` for a post-output footer.
124: * - **Streaming**: each yield is rendered immediately. Commands that support
125: * `--json` must yield one aggregate value when callers need one parseable
126: * JSON document; individual JSON chunks are pretty-printed, not JSONL.
127: * - **Void**: return without yielding for early exits (e.g. `--web`).
128: *
129: * The return value (`CommandReturn`) is captured by the wrapper and
130: * rendered after all yields are consumed. Hints live exclusively on
131: * the return value — never on individual yields. ...
<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. ...
/**
* 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 {
extractSchemaFields,
type SchemaFieldInfo,
} from "./formatters/output.js";
import { fuzzyMatch } from "./fuzzy.js";
// ---------------------------------------------------------------------------
// Stricli Runtime Types (simplified for introspection)
// ---------------------------------------------------------------------------
/** Entry in a Stricli route map as returned by getAllEntries() */
export type RouteMapEntry = {
name: { original: string };
target: RouteTarget;
hidden: ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: lines.push("|----------|-------------|");
157: for (const p of positionals) {
158: const syntax = p.optional ? `[<${p.placeholder}>]` : `<${p.placeholder}>`;
159: const placeholder = `\`${syntax}\``;
160: lines.push(`| ${placeholder} | ${escapeAngleBrackets(p.brief)} |`);
161: }
162: return lines.join("\n");
163: }
164:
165: /** Format flags as a markdown options table */
166: function formatFlagsTable(
167: flags: FlagInfo[],
168: aliases: Record<string, string>
169: ): string ...
I’m validating the two remaining cross-cutting risks: required variadic arguments being labeled optional, and whether metadata examples can bypass fragment coverage without proving they belong to the command.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
140: ...args: ARGS
141: // biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system
142: ) => AsyncGenerator<unknown, CommandReturn | void, undefined>;
143:
144: /**
145: * Arguments for building a command with a local function.
146: * This is the subset of Stricli's CommandBuilderArguments that we support.
147: */
148: type LocalCommandBuilderArguments<
149: FLAGS extends BaseFlags,
150: ARGS extends BaseArgs,
151: CONTEXT extends CommandContext,
152: > = {
153: readonly parameters?: Record<string, unknown>;
154: readonly docs: CommandDocumentation;
155: readonly func: SentryCommandFunction<FLAGS, ARGS, CONTEXT>;
156: /**
157: * Output configuration — controls flag injection and auto-rendering. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
50: return { conversationId: trimmed };
51: }
52: const org = trimmed.slice(0, slashIdx);
53: const conversationId = trimmed.slice(slashIdx + 1);
54: if (!(org && conversationId)) {
55: throw new ContextError("Conversation ID", USAGE_HINT, []);
56: }
57: return { org, conversationId };
58: }
59:
60: export const viewCommand = buildCommand({
61: docs: {
62: brief: "View an agent conversation transcript",
63: customUsage: [USAGE],
64: fullDescription:
65: "View the full transcript of an agent conversation.\n\n" +
66: "The org is optional and auto-detected from your project context when\n" +
67: "omitted. Prefix the ID with an org slug to target a specific org.",
68: examples: [
69: {
70: description: "View full transcript (organization auto-detected)",
71: command: "sentry ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
90:
91: function jsonTransform(
92: result: ConversationListResult,
93: fields?: string[]
94: ): unknown {
95: const items =
96: fields && fields.length > 0
97: ? result.conversations.map((c) => filterFields(c, fields))
98: : result.conversations;
99:
100: const envelope: Record<string, unknown> = {
101: data: items,
102: hasMore: result.hasMore,
103: hasPrev: !!result.hasPrev,
104: };
105: if (result.nextCursor) {
106: envelope.nextCursor = result.nextCursor;
107: }
108: return envelope;
109: }
110:
111: export const listCommand = buildListCommand("agent-conversation", {
112: docs: {
113: brief: "List recent agent conversations",
114: fullDescription:
115: "List recent agent conversations from a Sentry organization.\n\n" +
116: "The organization is auto-detected when omitted.",
117: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts</path>
<type>file</type>
<content>
215:
216: /**
217: * Given a route map target, find the name of its default command (if any).
218: * Compares the default command object reference against all subcommand entries.
219: */
220: function findDefaultInRouteMap(target: RouteMap): string | undefined {
221: if (!target.getDefaultCommand) {
222: return;
223: }
224: const defaultCmd = target.getDefaultCommand();
225: if (!defaultCmd) {
226: return;
227: }
228: for (const sub of target.getAllEntries()) {
229: if (sub.target === defaultCmd) {
230: return sub.name.original;
231: }
232: }
233: return;
234: }
235:
236: /**
237: * Extract the default command name for a route by inspecting the Stricli route map.
238: * Returns the default command name (e.g., "serve" for `local`) or undefined. ...
<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>
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
I’m completing the exact-patch review now. The worktree remains unchanged; git diff --check passes.
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
<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/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/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 ...
<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/script/generate-command-docs.ts</path>
<type>file</type>
<content>
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: lines.push("|----------|-------------|");
157: for (const p of positionals) {
158: const syntax = p.optional ? `[<${p.placeholder}>]` : `<${p.placeholder}>`;
159: const placeholder = `\`${syntax}\``;
160: lines.push(`| ${placeholder} | ${escapeAngleBrackets(p.brief)} |`);
161: }
162: return lines.join("\n");
163: }
164:
165: /** Format flags as a markdown options table */
166: function formatFlagsTable(
167: flags: FlagInfo[],
168: aliases: Record<string, string>
169: ): string ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
185: // ---------------------------------------------------------------------------
186: // Extraction Functions
187: // ---------------------------------------------------------------------------
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: ...
I found a cross-command inconsistency in the new optional-argument rendering. I’m tracing it to commands that enforce a non-empty variadic positional so I can classify it with deterministic evidence rather than treating it as cosmetic.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
165: throw new CliError(
166: `Failed to create project '${name}' in ${orgSlug}.\n\n` +
167: `Team '${teamSlug}' exists but the request was rejected. ` +
168: "You may lack permission to create projects in this team."
169: );
170: }
171:
172: if (teams.length > 0) {
173: throw new ResolutionError(
174: `Team '${teamSlug}'`,
175: `not found in ${orgSlug}`,
176: `sentry project create ${orgSlug}/${name}:${platform} --team <team-slug>`,
177: [`Available teams: ${teams.map((t) => t.slug).join(", ")}`]
178: );
179: }
180: throw new CliError(
181: `No teams found in ${orgSlug}.\n\n` +
182: "Create a team first, then try again."
183: );
184: }
185:
186: // listTeams returned 404 → org doesn't exist
187: // Delegates to shared helper that handles ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 465: function parseProjectSpecs(rawSpecs: readonly string[]): {
Line 637: kind: "array",
Line 649: optional: true,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
450: }
451:
452: const rawName = rawSpec.slice(0, separatorIndex);
453: const platform = parseProjectPlatform(
454: rawName,
455: rawSpec.slice(separatorIndex + 1)
456: );
457: return parseProjectName(rawName, platform);
458: }
459:
460: /**
461: * Parse one or more `[<org>/]<name>:<platform>` pairs, then require explicit
462: * org prefixes to agree. A lone positional with no colon at all gets a
463: * friendlier "platform is required" error instead of the generic syntax error.
464: */
465: function parseProjectSpecs(rawSpecs: readonly string[]): {
466: explicitOrg?: string;
467: parsed: ParsedProjectSpec[];
468: } {
469: if (rawSpecs.length === 0) {
470: throw new ContextError("Project specification", USAGE_HINT, []);
471: }
472:
473: if (rawSpecs.length === 1 && !rawSpecs[0]?.includes(":")) {
474: throw new ...
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts index cdc8865be..8c9ce6332 100644 --- a/packages/cli/script/generate-command-docs.ts +++ b/packages/cli/script/generate-command-docs.ts @@ -1,67 +1,68 @@ #!/usr/bin/env tsx /** * Generate Command Reference & Configuration Documentation * * Introspects the CLI's route tree and env var registry to generate * accurate reference pages for the documentation website. Flags, arguments, * aliases, and environment variables are extracted directly from source code, * preventing documentation drift. * * Each generated page combines: - * 1. Auto-generated reference — from CLI metadata or env registry - * 2. Hand-written fragment — examples, guides, tips (from docs/src/fragments/) + * 1. Auto-generated reference and examples from CLI metadata or env registry + * 2. Hand-written guides and tips from docs/src/fragments/ * * The generated output is gitignored. ...
<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/src/lib/help.ts</path>
<type>file</type>
<content>
640: *
641: * Matches Stricli's "did you mean" style:
642: * - 1 item: `"issue"`
643: * - 2 items: `"issue or trace"`
644: * - 3 items: `"issue, trace, or auth"`
645: */
646: function formatSuggestionList(items: string[]): string {
647: if (items.length <= 1) {
648: return items.join("");
649: }
650: if (items.length === 2) {
651: return `${items[0]} or ${items[1]}`;
652: }
653: return `${items.slice(0, -1).join(", ")}, or ${items.at(-1)}`;
654: }
655:
656: // ---------------------------------------------------------------------------
657: // Human Rendering of Introspection Data
658: // ---------------------------------------------------------------------------
659:
660: /**
661: * Format a single flag for human display. ...
I’m checking the structured introspection surface separately from native help. The wrapper currently modifies the Stricli fullDescription to render native examples, so I need to verify whether that transformed prose leaks into help --json alongside the new structured examples field.
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/tsx@4.23.5/node_modules/tsx/dist/register-CptX03bE.cjs:9
`)},"createLog"),G=pt(W.bgLightYellow(W.black(" CJS "))),Tn=pt(W.bgBlue(" ESM ")),R=new Map,Sn=u(async e=>{if(R.has(e))return R.get(e);if(!await _.promises.access(e).then(()=>!0,()=>!1)){R.set(e,void 0);return}const r=await _.promises.readFile(e,"utf8");try{const n=JSON.parse(r);return R.set(e,n),n}catch{throw new Error(`Error parsing: ${e}`)}},"readPackageJson"),On=u(e=>{if(R.has(e))return R.get(e);if(!_.existsSync(e)){R.set(e,void 0);return}const t=_.readFileSync(e,"utf8");try{const r=JSON.parse(t);return R.set(e,r),r}catch{throw new Error(`Error parsing: ${e}`)}},"readPackageJsonSync"),An=u(async e=>{let t=new URL("package.json",e);for(;!t.pathname.endsWith("/node_modules/package.json");){const r=Q.fileURLToPath(t),n=await Sn(r);if(n)return n;const s=t;if(t=new URL("../package.json",t),t.pathname===s.pathname)break}},"findPackageJson"),ft=u(e=>{let t=new ...
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,24 +1,25 @@
/**
* 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";
// ---------------------------------------------------------------------------
// ...
Found 3 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.");
<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: ...
I found one concrete cross-command inconsistency and am checking its reach before assigning severity: array positionals render as required in command signatures but are always marked optional in structured argument metadata. The new table renderer therefore publishes [<name:platform...>] for project create, even though the command requires one or more pairs and its canonical signature says <name>:<platform>....
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. Create several projects at once\n" +
616: "by passing multiple pairs as separate arguments. All projects share one org.\n\n" +
617: "Projects are created under a team. ...
<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: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
628: jsonExclude: [
629: "slugDiverged",
630: "expectedSlug",
631: "teamSource",
632: "requestedPlatform",
633: ],
634: },
635: parameters: {
636: positional: {
637: kind: "array",
638: parameter: {
639: placeholder: "name:platform",
640: brief: "One or more project name and platform pairs",
641: parse: String,
642: },
643: },
644: flags: {
645: team: {
646: kind: "parsed",
647: parse: String,
648: brief: "Team to create the project under",
649: optional: true,
650: },
651: "dry-run": DRY_RUN_FLAG,
652: },
653: aliases: { ...DRY_RUN_ALIASES, t: "team" },
654: },
655: async *func(this: SentryContext, flags: CreateFlags, ...args: string[]) {
656: const { cwd } = this;
657:
658: const { explicitOrg, parsed } = ...
I’m verifying the two cross-cutting defects against generated output and the runtime metadata shape, then I’ll finish the review with exact current line evidence.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts help agent-conversation list --json
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, ...
Found 34 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 70: | { kind: "array"; parameter: PositionalParam };
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 484: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 130: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/merge.ts:
Line 276: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts:
Line 384: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts:
Line 575: kind: "array",
/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/send-envelope.ts:
Line 26: kind: ...
No files found
> sentry@0.45.0-dev.0 generate:command-docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-command-docs.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-command-docs.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Generated 36 command doc pages + ../../apps/cli-docs/src/content/docs/commands/index.md + ../../apps/cli-docs/src/content/docs/configuration.md
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
25: * telemetry and global flag handling.
26: *
27: * ```
28: * Correct: import { buildCommand } from "../../lib/command.js";
29: * Incorrect: import { buildCommand } from "@stricli/core"; // skips everything!
30: * ```
31: */
32:
33: import {
34: type Command,
35: type CommandContext,
36: buildCommand as stricliCommand,
37: numberParser as stricliNumberParser,
38: } from "@stricli/core";
39: import type { Writer } from "../types/index.js";
40: import { appendCacheHint } from "./cache-hint.js";
41: import { getAuthConfig } from "./db/auth.js";
42: import { getEnv } from "./env.js";
43: import { AuthError, CliError, OutputError } from "./errors.js";
44: import { warning } from "./formatters/colors.js";
45: import { parseFieldsList } from "./formatters/json.js";
46: import {
47: ClearScreen,
48: CommandOutput,
49: type CommandReturn,
50: ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md: Line 18: | `[<name:platform...>]` | One or more project name and platform pairs | Line 123: # Every project is a name:platform pair; project names cannot contain whitespace
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts:
Line 79: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts:
Line 200: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/index.ts:
Line 10: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 468: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 100: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 199: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/index.ts:
Line 19: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/team/index.ts:
Line 8: docs: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts:
Line 27: docs: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. */
100: readonly description: string;
101: /** Complete command line, including the `sentry` executable. */
102: readonly command: string;
103: };
104:
105: /**
106: * Native Stricli documentation plus metadata for generated docs. ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
185: // ---------------------------------------------------------------------------
186: // Extraction Functions
187: // ---------------------------------------------------------------------------
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: ...
I’m validating the remaining cross-cutting issues against actual JSON help and generated output before issuing the findings-first verdict.
<anonymous_script>:2
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
^
SyntaxError: Unexpected token '>', "
> sentry@0"... is not valid JSON
at JSON.parse (<anonymous>)
at Socket.<anonymous> ([eval]:1:101)
at Socket.emit (node:events:521:24)
at endReadableNT (node:internal/streams/readable:1735:12)
at process.processTicksAndRejections (node:internal/process/task_queues:90:21)
Node.js v24.16.0
.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.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, optional)\n flow (array)\n errors (number)\n llmCalls (number)\n toolCalls (number)\n totalTokens ...
Found 11 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 420: function enrichDocsWithSchema(
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 441: function prepareNativeDocs(
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
Line 459: function attachDocumentationMetadata(
Line 563: const stricliDocs = enrichDocsWithSchema(
Line 564: prepareNativeDocs(builderArgs.docs),
Line 885: docs: stricliDocs,
Line 890: attachDocumentationMetadata(cmd, builderArgs.docs);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
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. ...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
85: long: "--version",
86: description: "Show version",
87: },
88: ];
89:
90: /**
91: * Generate the commands list dynamically from Stricli's route structure.
92: * This ensures help text stays in sync with actual registered commands.
93: */
94: function generateCommands(): HelpCommand[] {
95: // Cast to our introspection types — Stricli's generic types are compatible
96: const routeMap = routes as unknown as RouteMap;
97: const entries = routeMap.getAllEntries();
98:
99: return entries
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible subcommand names and join with pipes
107: const subEntries = entry.target
108: ...
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 694: function formatCommandHuman(cmd: CommandInfo): string {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
660: /**
661: * Format a single flag for human display.
662: *
663: * @param flag - The flag info to format
664: * @param aliases - Command alias map for short flag lookup
665: * @returns Formatted flag string like "-l, --limit <value> - Max items"
666: */
667: function formatFlagHuman(
668: flag: import("./introspect.js").FlagInfo,
669: aliases: Record<string, string>
670: ): string {
671: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
672: let syntax = `--${flag.name}`;
673: if (alias) {
674: syntax = `-${alias}, ${syntax}`;
675: }
676: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
677: syntax += " <value>";
678: } else if (flag.variadic) {
679: syntax += " <value>...";
680: }
681: const parts = [syntax];
682: if (flag.brief) {
683: parts.push(flag.brief);
684: }
685: if ...
Found 6 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md: Line 14: ### `sentry project create [<org>/]<name>:<platform>...` Line 25: # Every project is a name:platform pair; project names cannot contain whitespace Line 27: sentry project create my-new-app:javascript-nextjs Line 30: sentry project create web:javascript api:python-django worker:node Line 33: sentry project create my-org/my-new-app:python --team backend-team Line 36: sentry project create my-new-app:node --dry-run
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: ...
I’m validating the two cross-cutting metadata inconsistencies against live CLI output before issuing the review verdict.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry agent-conversation list",
"brief": "List recent agent conversations",
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, optional)\n flow (array)\n errors (number)\n llmCalls (number)\n toolCalls (number)\n totalTokens (number)\n totalCost (number)\n startTimestamp (number)\n endTimestamp (number)\n traceCount ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_084e60edd001xbPN5diH5U7NZz
import { setArgsContext, setFlagContext, withTracing } from "./telemetry.js";
/**
* Parse a string input as a number.
* Re-exported from Stricli for convenience.
*/
export const numberParser = stricliNumberParser;
/** Base flags type from Stricli */
type BaseFlags = Readonly<Partial<Record<string, unknown>>>;
/** Base args type from Stricli */
type BaseArgs = readonly unknown[];
/**
* Type-erased Stricli builder arguments.
*
* At the `stricliCommand()` call site we've modified both `parameters`
* (injected hidden flags) and `func` (wrapped with telemetry/output
* logic), which breaks the original `FLAGS`/`ARGS` generic alignment
* that Stricli's `CommandBuilderArguments` enforces via `NoInfer`. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-project 3: version: 0.45.0-dev.0 4: description: Work with Sentry projects 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Project Commands 11: 12: Work with Sentry projects 13: 14: ### `sentry project create [<org>/]<name>:<platform>...` 15: 16: Create one or more projects 17: 18: **Flags:** 19: - `-t, --team <value> - Team to create the project under` 20: - `-n, --dry-run - Show what would happen without making changes` 21: 22: **Examples:** 23: 24: ```bash 25: # Every project is a name:platform pair; project names cannot contain whitespace 26: # Create a new project 27: sentry project create my-new-app:javascript-nextjs 28: 29: # Create several projects with their own platforms 30: sentry project create web:javascript api:python-django worker:node 31: 32: # Create under a specific ...
No files found
I found one confirmed generated-reference regression. I’m checking whether the second metadata inconsistency changes the public help --json contract or only duplicates internal native-help prose.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter conversations\n sentry agent-conversation list my-org -c next # Paginate through results\n\nJSON fields (use --json --fields to select):\n conversationId (string)\n title (string | null, optional)\n flow (array)\n errors (number)\n llmCalls (number)\n toolCalls (number)\n totalTokens (number)\n totalCost (number)\n startTimestamp (number)\n endTimestamp (number)\n traceCount (number)\n traceIds (array)\n firstInput (string | null)\n lastOutput (string | null)\n ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
185: // ---------------------------------------------------------------------------
186: // Extraction Functions
187: // ---------------------------------------------------------------------------
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
410: ...FIELDS_FLAG,
411: brief: `${FIELDS_FLAG.brief}. Available: ${fieldNames}`,
412: };
413: }
414:
415: /**
416: * Enrich command docs with a JSON fields section when a schema is registered.
417: * Appends available field names and types to `fullDescription` so they appear
418: * in Stricli's `--help` output.
419: */
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-project 3: version: 0.45.0-dev.0 4: description: Work with Sentry projects 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Project Commands 11: 12: Work with Sentry projects 13: 14: ### `sentry project create [<org>/]<name>:<platform>...` 15: 16: Create one or more projects 17: 18: **Flags:** 19: - `-t, --team <value> - Team to create the project under` 20: - `-n, --dry-run - Show what would happen without making changes` 21: 22: **Examples:** 23: 24: ```bash 25: # Every project is a name:platform pair; project names cannot contain whitespace 26: # Create a new project 27: sentry project create my-new-app:javascript-nextjs 28: 29: # Create several projects with their own platforms 30: sentry project create web:javascript api:python-django worker:node 31: 32: # Create under a specific ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
I’ve confirmed the two cross-cutting inconsistencies in live output. I’m finishing the findings against the exact diff and prior test evidence; the worktree remains unchanged.
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
Found 34 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 70: | { kind: "array"; parameter: PositionalParam };
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 484: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 130: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts:
Line 36: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 637: 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/proguard/upload.ts:
Line 172: kind: ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_084eddca1001rYFe1KYkMc6nG9
*/
type SentryCommandFunction<
FLAGS extends BaseFlags,
ARGS extends BaseArgs,
CONTEXT extends CommandContext,
> = (
this: CONTEXT,
flags: FLAGS,
...args: ARGS
// biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system
) => AsyncGenerator<unknown, CommandReturn | void, undefined>;
/**
* Arguments for building a command with a local function.
* This is the subset of Stricli's CommandBuilderArguments that we support.
*/
type LocalCommandBuilderArguments<
FLAGS extends BaseFlags,
ARGS extends BaseArgs,
CONTEXT extends CommandContext,
> = {
readonly parameters?: Record<string, unknown>;
readonly docs: CommandDocumentation;
readonly func: SentryCommandFunction<FLAGS, ARGS, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: /**
218: * Extract ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
410: ...FIELDS_FLAG,
411: brief: `${FIELDS_FLAG.brief}. Available: ${fieldNames}`,
412: };
413: }
414:
415: /**
416: * Enrich command docs with a JSON fields section when a schema is registered.
417: * Appends available field names and types to `fullDescription` so they appear
418: * in Stricli's `--help` output.
419: */
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
275: hidden: def.hidden ?? false,
276: }));
277: }
278:
279: /**
280: * Build a {@link CommandInfo} from a Stricli Command.
281: *
282: * @param cmd - The Stricli command to introspect
283: * @param path - Full command path (e.g. "sentry issue list")
284: * @param examples - Optional usage examples
285: */
286: export function buildCommandInfo(
287: cmd: Command,
288: path: string,
289: examples: string[] = []
290: ): CommandInfo {
291: const jsonFields = cmd.__jsonSchema
292: ? extractSchemaFields(cmd.__jsonSchema)
293: : undefined;
294:
295: return {
296: path,
297: brief: cmd.brief,
298: fullDescription: cmd.fullDescription,
299: flags: extractFlags(cmd.parameters.flags),
300: positional:
301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
302: positionals: ...
/**
* 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 {
buildListCommand,
LIST_DEFAULT_LIMIT,
LIST_MAX_LIMIT,
LIST_MIN_LIMIT,
LIST_PERIOD_FLAG,
PERIOD_ALIASES,
paginationHint,
} from "../../lib/list-command.js";
import { withProgress } from "../../lib/polling.js";
import { resolveOrg } from "../../lib/resolve-target.js";
import {
appendPeriodHint,
...
Found 9 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 318: * @param docExamples - Optional examples loaded from documentation
Line 320: export function extractRouteGroupCommands(
Line 323: docExamples: Map<string, string[]> = new Map()
Line 335: const examples = docExamples.get(path) ?? [];
Line 340: ...extractRouteGroupCommands(subTarget, nestedPrefix, docExamples)
Line 356: export function extractAllRoutes(routeMap: RouteMap): RouteInfo[] {
Line 371: commands: extractRouteGroupCommands(target, routeName),
Line 446: commands: extractRouteGroupCommands(target, entry.name.original),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 354: routes: extractAllRoutes(routeMap),
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,194 +1,213 @@
/**
* 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 { ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: /**
218: * Extract ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = docs.fullDescription ?? docs.brief;
434: return {
435: ...docs,
436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
437: };
438: }
439:
440: /** Convert extended command docs into native Stricli help documentation. ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -186,128 +186,131 @@ function fragmentMentionsSubcommand(
const proseOnly = stripCodeBlocks(content);
const escapedLeaf = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
const headingRe = new RegExp(`^#{1,4}\\s+.*\\b${escapedLeaf}\\b`, "im");
if (headingRe.test(proseOnly)) {
return true;
}
return false;
}
/**
* Build a map of route name → RouteInfo for routes with multiple subcommands.
* Standalone commands (single command matching `sentry <name>`) are skipped
* since there's nothing to check — the fragment covers the whole command. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
410: ...FIELDS_FLAG,
411: brief: `${FIELDS_FLAG.brief}. Available: ${fieldNames}`,
412: };
413: }
414:
415: /**
416: * Enrich command docs with a JSON fields section when a schema is registered.
417: * Appends available field names and types to `fullDescription` so they appear
418: * in Stricli's `--help` output.
419: */
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = ...
No files found
No files found
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
100: return cmd.flags.filter((f) => !(f.hidden || GLOBAL_FLAG_NAMES.has(f.name)));
101: }
102:
103: /**
104: * Format a flag as a table row: `| -q, --query <query> | Search query ... |`
105: *
106: * Uses the flag name as the value placeholder for readability
107: * (e.g., `--limit <limit>` instead of `--limit <value>`).
108: */
109: function formatFlagRow(
110: flag: FlagInfo,
111: aliases: Record<string, string>
112: ): string {
113: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
114:
115: let syntax = `--${flag.name}`;
116: if (alias) {
117: syntax = `-${alias}, ${syntax}`;
118: }
119: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
120: syntax += ` <${flag.name}>`;
121: } else if (flag.variadic) {
122: syntax += ` <${flag.name}>...`;
123: }
124:
125: let desc = ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.cts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.cjs
Found 24 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 976: interface TypedCommandPositionalParameters_<ARGS extends BaseArgs, CONTEXT extends CommandContext> {
Line 980: readonly positional: TypedPositionalParameters<ARGS, CONTEXT>;
Line 982: type TypedCommandPositionalParameters<ARGS extends BaseArgs, CONTEXT extends CommandContext> = [] extends ARGS ? Partial<TypedCommandPositionalParameters_<ARGS, CONTEXT>> : TypedCommandPositionalParameters_<ARGS, CONTEXT>;
Line 986: type TypedCommandParameters<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = TypedCommandFlagParameters<FLAGS, CONTEXT> & TypedCommandPositionalParameters<ARGS, CONTEXT>;
Line 995: readonly positional?: PositionalParameters;
Line 998: interface BasePositionalParameter<T, CONTEXT extends CommandContext> extends ParsedParameter<T, CONTEXT> {
Line 1014: interface RequiredPositionalParameter<T, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path>
<type>file</type>
<content>
990: * internally and should only be used after the types are checked.
991: */
992: interface CommandParameters {
993: readonly flags?: FlagParameters;
994: readonly aliases?: Aliases<string>;
995: readonly positional?: PositionalParameters;
996: }
997:
998: interface BasePositionalParameter<T, CONTEXT extends CommandContext> extends ParsedParameter<T, CONTEXT> {
999: /**
1000: * In-line documentation for this parameter.
1001: */
1002: readonly brief: string;
1003: /**
1004: * String that serves as placeholder for the value in the generated usage line.
1005: * Defaults to "argN" where N is the index of this parameter.
1006: */
1007: readonly placeholder?: string;
1008: /**
1009: * Default input value if one is not provided at runtime.
1010: */
1011: readonly default?: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
38: getAllEntries: () => RouteMapEntry[];
39: /** Returns the default command if one is configured, undefined otherwise */
40: getDefaultCommand?: () => unknown;
41: };
42:
43: /** A leaf command with parameters */
44: export type Command = {
45: brief: string;
46: fullDescription?: string;
47: parameters: {
48: positional?: PositionalParams;
49: flags?: Record<string, FlagDef>;
50: aliases?: Record<string, string>;
51: };
52: /**
53: * JSON output schema attached by `buildCommand` when `output.schema` is set.
54: * Non-standard property — Stricli doesn't know about it, but introspection
55: * reads it to populate {@link CommandInfo.jsonFields}.
56: */
57: __jsonSchema?: import("valibot").GenericSchema;
58: /**
59: * Primary Stricli custom usage line, retained by `buildCommand` for
60: * introspection because Stricli does ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
67: /** Positional parameter definitions — either fixed-length tuple or variadic array */
68: export type PositionalParams =
69: | { kind: "tuple"; parameters: readonly PositionalParam[] }
70: | { kind: "array"; parameter: PositionalParam };
71:
72: /** A single positional parameter with optional brief and placeholder */
73: export type PositionalParam = {
74: brief?: string;
75: placeholder?: string;
76: optional?: boolean;
77: };
78:
79: /** Extracted metadata for a single positional argument */
80: export type PositionalInfo = {
81: placeholder: string;
82: brief: string;
83: optional: boolean;
84: };
85:
86: /** Flag definition as stored in Stricli's command parameters */
87: export type FlagDef = {
88: kind: "boolean" | "parsed" | "enum";
89: brief?: string;
90: default?: unknown;
91: optional?: boolean;
92: variadic?: boolean;
93: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: /**
218: * Extract ...
Found 7 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 434: var UnsatisfiedPositionalError = class extends ArgumentScannerError {
Line 440: * If specified, indicates the minimum number of arguments that are expected and the last argument count.
Line 821: if (typeof positional.minimum === "number" && positionalIndex < positional.minimum) {
Line 823: new UnsatisfiedPositionalError(getPlaceholder(positional.parameter), [
Line 824: positional.minimum,
Line 847: throw new UnsatisfiedPositionalError(placeholder);
Line 2319: UnsatisfiedPositionalError,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
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 = nextFlags[0].namedFlag;
796: }
797: return;
798: }
799: }
800: if (activeFlag) {
801: storeInput(flagInputs, config.caseStyle, activeFlag, input);
802: activeFlag = void 0;
803: } else {
804: if (positional.kind === "tuple") {
805: if (positionalIndex >= positional.parameters.length) {
806: throw new UnexpectedPositionalError(positional.parameters.length, input);
807: }
808: } ...
<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" ...
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. Hand-written fragment — examples, guides, tips (from docs/src/fragments/)
+ * 1. Auto-generated reference and examples from CLI metadata or env registry
+ * 2. Hand-written guides and tips from docs/src/fragments/
*
* The generated output is gitignored. Fragment files are the committed
- * source of truth for custom content.
+ * source of truth for content that cannot live in command definitions.
*
* Usage:
* tsx script/generate-command-docs.ts
@@ -25,6 +25,7 @@
import { mkdirSync, rmSync } from "node:fs";
import { access, readFile, writeFile } from ...
<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/content/docs/commands/project.md</path> <type>file</type> <content> 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: (Showing lines 8-32 of 145. Use offset=33 to continue.) </content>
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = docs.fullDescription ?? docs.brief;
434: return {
435: ...docs,
436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
437: };
438: }
439:
440: /** Convert extended command docs into native Stricli help documentation. */
441: function prepareNativeDocs(
442: docs: CommandDocumentation
443: ): StricliBuilderArgs<CommandContext>["docs"] {
444: const { examples, ...nativeDocs } = docs;
445: if (!examples?.length) {
446: return nativeDocs;
447: }
448:
449: const renderedExamples = examples
450: .map(({ description, command }) => ` ${command} # ${description}`)
451: .join("\n");
452: return {
453: ...nativeDocs,
454: fullDescription: `${nativeDocs.fullDescription ?? ...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
185: // ---------------------------------------------------------------------------
186: // Page Generation
187: // ---------------------------------------------------------------------------
188:
189: /** Generate the auto-generated reference section for a single command */
190: function generateCommandSection(cmd: CommandInfo): string {
191: const lines: string[] = [];
192:
193: // Command heading
194: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
195: lines.push(`### \`${signature}\``);
196: lines.push("");
197: lines.push(cmd.brief);
198:
199: // Arguments table
200: if (cmd.positionals.length > 0) {
201: lines.push("");
202: lines.push(formatPositionalsTable(cmd.positionals));
203: }
204:
205: // Options table
206: const visibleFlags = getVisibleFlags(cmd);
207: if (visibleFlags.length > 0) ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
250: lines.push(npmCommand);
251: }
252: lines.push("```");
253: }
254: return lines;
255: }
256:
257: /** Generate authentication section from docs content */
258: function generateAuthSection(authSection: string): string[] {
259: const lines: string[] = [];
260: lines.push("### Authentication");
261: lines.push("");
262: const codeBlocks = extractCodeBlocks(authSection, "bash");
263: if (codeBlocks.length > 0) {
264: lines.push("```bash");
265: for (const block of codeBlocks) {
266: lines.push(block.code);
267: }
268: lines.push("```");
269: }
270: return lines;
271: }
272:
273: /** Load prerequisites (installation + authentication) from getting-started.mdx */
274: async function loadPrerequisites(): Promise<string> {
275: const fullPath = `${DOCS_PATH}/getting-started.mdx`;
276: const exists = await ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 566: function generateFullCommandDoc(cmd: CommandInfo): string {
Line 598: const examples = formatCommandExamples(cmd.examples);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
550: return parts.join(" - ");
551: }
552:
553: /**
554: * Get the visible, non-global flags for a command.
555: * Excludes hidden flags, help, and globally-injected flags.
556: */
557: function getVisibleFlags(cmd: CommandInfo): FlagInfo[] {
558: return cmd.flags.filter((f) => !(f.hidden || GLOBAL_FLAG_NAMES.has(f.name)));
559: }
560:
561: // ---------------------------------------------------------------------------
562: // Reference File Generation (full detail)
563: // ---------------------------------------------------------------------------
564:
565: /** Generate full documentation for a single command (used in reference files) */
566: function generateFullCommandDoc(cmd: CommandInfo): string {
567: const lines: string[] = [];
568: const signature = cmd.positional ? `${cmd.path} ${cmd.positional}` : cmd.path;
569: lines.push(`### ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/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/introspect.ts</path>
<type>file</type>
<content>
40: getDefaultCommand?: () => unknown;
41: };
42:
43: /** A leaf command with parameters */
44: export type Command = {
45: brief: string;
46: fullDescription?: string;
47: parameters: {
48: positional?: PositionalParams;
49: flags?: Record<string, FlagDef>;
50: aliases?: Record<string, string>;
51: };
52: /**
53: * JSON output schema attached by `buildCommand` when `output.schema` is set.
54: * Non-standard property — Stricli doesn't know about it, but introspection
55: * reads it to populate {@link CommandInfo.jsonFields}.
56: */
57: __jsonSchema?: import("valibot").GenericSchema;
58: /**
59: * Primary Stricli custom usage line, retained by `buildCommand` for
60: * introspection because Stricli does not expose it on the built command.
61: */
62: __primaryUsage?: string;
63: /** Canonical documentation examples retained ...
I’m completing the review against the current patch and turning the two observed metadata inconsistencies into evidence-backed findings. I will keep the worktree untouched.
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. */
100: readonly description: string;
101: /** Complete command line, including the `sentry` executable. */
102: readonly command: string;
103: };
104:
105: /**
106: * Native Stricli documentation plus metadata for generated docs. ...
<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/src/lib/command.ts</path>
<type>file</type>
<content>
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 ?? ...
No files found
I’ve recovered the exact review contract. I’m checking each hand-written source and test hunk, then the generated artifacts, before issuing the required findings-first verdict.
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_0850ba3e3001c6k75fJzdLo5dO
readonly output?: OutputConfig<any>;
/**
* Whether the command requires authentication. Defaults to `true`.
*
* When `true` (the default), the command throws `AuthError("not_authenticated")`
* before executing if no credentials exist at all (no token or refresh token
* in the DB or env vars). Expired tokens with a valid refresh token pass the
* guard — the API client handles silent refresh. The auto-auth middleware in
* `cli.ts` catches the error and triggers the login flow.
*
* Set to `false` for commands that intentionally work without a token
* (e.g. `auth login`, `auth logout`, `auth status`, `help`, `cli upgrade`).
*
* Set to `"dsn"` for commands that authenticate via a Sentry DSN instead of
* a Bearer token (e.g. `event send`). These commands skip
* the token guard and the `.sentryclirc` URL trust ...
apps/cli-docs/src/fragments/commands/agent-conversation.md packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/repo.md packages/cli/plugins/sentry-cli/skil...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
No files found
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
@@ -226,80 +226,83 @@ function findDefaultInRouteMap(target: RouteMap): string | undefined {
return;
}
for (const sub of target.getAllEntries()) {
if (sub.target === defaultCmd) {
return sub.name.original;
}
}
return;
}
/**
* Extract the default command name for a route by inspecting the Stricli route map.
* Returns the default command name (e.g., "serve" for `local`) or undefined.
*/
function getDefaultCommandName(routeName: string): string | undefined {
for (const entry of routeMap.getAllEntries()) {
if (entry.name.original !== routeName) {
continue;
}
return findDefaultInRouteMap(entry.target as RouteMap);
}
return;
}
const multiCommandRoutes = getMultiCommandRoutes();
for (const ...
I’ve isolated one definite cross-surface contradiction in variadic positional metadata. I’m tracing the second candidate through the JSON-help contract and its tests now, so the verdict distinguishes a real regression from intentional native-help duplication.
No files found
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_085112511001Cbcu49bcoHenJX
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. When
+ * `customUsage` is present, its first line is the canonical signature suffix;
+ * later lines may document equivalent forms.
*/
-type CommandDocumentation = StricliBuilderArgs<CommandContext>["docs"];
+export type CommandDocumentation =
+ StricliBuilderArgs<CommandContext>["docs"] & {
+ /** Canonical examples consumed by generated documentation. */
+ readonly examples?: readonly CommandExample[];
+ };
/**
* Command function type for Sentry CLI commands.
*
* ALL command functions are async generators. The framework iterates
* each yielded value and renders it through the output config. ...
ripgrep execution failed
No files found
I have the exact review contract and will finish from the current immutable patch. I’ll verify the two candidate defects against source, generated output, and focused tests, then return the required findings-first merge verdict.
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<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/commands/project/create.ts</path>
<type>file</type>
<content>
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. Create several projects at once\n" +
616: "by passing multiple pairs as separate arguments. All projects share one org.\n\n" +
617: "Projects are created under a team. ...
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/view.ts:
Line 46: const USAGE_HINT = "sentry project view <org>/<project>";
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 65: const USAGE_HINT = "sentry project create [<org>/]<name>:<platform>...";
Line 465: function parseProjectSpecs(rawSpecs: readonly string[]): {
Line 658: const { explicitOrg, parsed } = parseProjectSpecs(args);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
445: if (separatorIndex === -1) {
446: throw new ValidationError(
447: `Project '${rawSpec}' must use <name>:<platform> syntax.`,
448: "project"
449: );
450: }
451:
452: const rawName = rawSpec.slice(0, separatorIndex);
453: const platform = parseProjectPlatform(
454: rawName,
455: rawSpec.slice(separatorIndex + 1)
456: );
457: return parseProjectName(rawName, platform);
458: }
459:
460: /**
461: * Parse one or more `[<org>/]<name>:<platform>` pairs, then require explicit
462: * org prefixes to agree. A lone positional with no colon at all gets a
463: * friendlier "platform is required" error instead of the generic syntax error.
464: */
465: function parseProjectSpecs(rawSpecs: readonly string[]): {
466: explicitOrg?: string;
467: parsed: ParsedProjectSpec[];
468: } {
469: if (rawSpecs.length === 0) {
470: ...
No files found
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
@@ -236,60 +236,63 @@ function findDefaultInRouteMap(target: RouteMap): string | undefined {
/**
* Extract the default command name for a route by inspecting the Stricli route map.
* Returns the default command name (e.g., "serve" for `local`) or undefined.
*/
function getDefaultCommandName(routeName: string): string | undefined {
for (const entry of routeMap.getAllEntries()) {
if (entry.name.original !== routeName) {
continue;
}
return findDefaultInRouteMap(entry.target as RouteMap);
}
return;
}
const multiCommandRoutes = getMultiCommandRoutes();
for (const [routeName, route] of multiCommandRoutes) {
const fragmentPath = `${FRAGMENTS_DIR}/${routeName}.md`;
let content: string;
try {
content = await ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/version-check.test.ts:
Line 122: test("suppresses for --json flag", () => {
Line 123: expect(shouldSuppressNotification(["issue", "list", "--json"])).toBe(true);
Line 124: expect(shouldSuppressNotification(["--json", "issue", "list"])).toBe(true);
Line 343: ["json flag", ["issue", "list", "--json"]],
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/utils.test.ts:
Line 14: describe("JSDoc examples (canonical alignment)", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/arg-parsing.test.ts:
Line 57: // Representative examples for documentation (invariants covered by property tests)
Line 325: // Representative examples for documentation (invariants covered by property tests)
Line 326: describe("representative examples", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/scope-recovery.test.ts:
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
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 the primary custom usage line for introspection", () => {
182: const command = buildCommand<Record<string, never>, string[]>({
183: auth: false,
184: docs: {
185: brief: "Create things",
186: customUsage: ["<name>:<kind>..."],
187: },
188: parameters: {
189: positional: {
190: ...
/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md /home/byk/Code/getsentry/cli-pr-1558/.lore.md
I’m finishing the review now. I’m validating the two remaining cross-surface candidates against the base revision so I only report regressions introduced by this patch.
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_0851b53b9001PL6aWSE9xgHWKF
import { setArgsContext, setFlagContext, withTracing } from "./telemetry.js";
/**
* Parse a string input as a number.
* Re-exported from Stricli for convenience.
*/
export const numberParser = stricliNumberParser;
/** Base flags type from Stricli */
type BaseFlags = Readonly<Partial<Record<string, unknown>>>;
/** Base args type from Stricli */
type BaseArgs = readonly unknown[];
/**
* Type-erased Stricli builder arguments.
*
* At the `stricliCommand()` call site we've modified both `parameters`
* (injected hidden flags) and `func` (wrapped with telemetry/output
* logic), which breaks the original `FLAGS`/`ARGS` generic alignment
* that Stricli's `CommandBuilderArguments` enforces via `NoInfer`. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md</path> <type>file</type> <content> 1: # Jared (Outpost agent) 2: 3: Autonomous GitHub coding agent. Work in `/workspace/repo`. 4: 5: ## Model tiers 6: 7: The primary model is chosen per event (see `src/agents/models.ts`): heavy for 8: code-producing situations, cheaper for lightweight ones. 9: 10: | Role | Subagent | Model | 11: | --- | --- | --- | 12: | Triage / plan / review (heavy) | (primary Jared) | Claude Opus 4.8 | 13: | Triage / plan / review (light) | (primary Jared) | xAI Grok 4.3 | 14: | Explore | `explore` | OpenAI gpt-5-mini | 15: | Implement | `implement` | Moonshot kimi-k2.7-code | 16: | Ship (commit/push/PR) | `ship` | xAI Grok (`grok-build-0.1`) | 17: 18: Pipeline: triage → explore → plan → implement → review → ship. 19: (`worker` is a deprecated alias of `implement`.) 20: 21: Operators also talk to Jared directly from the Outpost dashboard. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/.lore.md</path>
<type>file</type>
<content>
1: <!-- Managed by lore (https://github.com/BYK/loreai) — manual edits are imported on next session. -->
2:
3: ## Long-term Knowledge
4:
5: ### Architecture
6:
7: <!-- lore:01a02357-f0a8-7fdb-9e9d-b0710cfe65c9 -->
8: * **API output binary and HTTP contracts**: Always preserve strict output-mode and binary-safety contracts. `sentry api` must preserve `rawApiRequest()` status text; empty textual non-2xx bodies must produce an HTTP status/request fallback, and JSON mode must expose `{status, statusText, body}` so empty success and error responses are distinguishable. Binary `Uint8Array` successes bypass formatters and remain raw; binary errors emit only status/content-type/byte-count summaries, never bytes or JSON coercion. Prompts must never block scripted runs or interleave with stdout JSON.
9:
10: <!-- lore:019ef480-47f1-7708-80cb-514ac37a3fde -->
11: * **@sentry/symbolic 13.4.0 API surface: ...
No files found
Found 17 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/init/verify-setup.ts: Line 360: * SDK is working or at minimum that the app starts without errors. /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/fuzzy.ts: Line 16: * @returns The minimum number of single-character edits (insert, delete, replace) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/text-table.ts: Line 53: /** Per-column minimum content widths. Columns will not shrink below these. */ Line 256: * excess over the minimum width. Line 684: /** Per-column minimum content widths. Columns will not shrink below these. */ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/sixel-dashboard.ts: Line 351: // rasterizeChart enforces a 16x8 minimum, which must never escape this /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/formatters/human.ts: Line 2056: * Contains the minimum context needed for both human and JSON ...
<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/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
440: * space-separated fallback — the platform must always be attached with `:`,
441: * with or without an explicit org prefix on the name.
442: */
443: function parsePairedProjectSpec(rawSpec: string): ParsedProjectSpec {
444: const separatorIndex = rawSpec.lastIndexOf(":");
445: if (separatorIndex === -1) {
446: throw new ValidationError(
447: `Project '${rawSpec}' must use <name>:<platform> syntax.`,
448: "project"
449: );
450: }
451:
452: const rawName = rawSpec.slice(0, separatorIndex);
453: const platform = parseProjectPlatform(
454: rawName,
455: rawSpec.slice(separatorIndex + 1)
456: );
457: return parseProjectName(rawName, platform);
458: }
459:
460: /**
461: * Parse one or more `[<org>/]<name>:<platform>` pairs, then require explicit
462: * org prefixes to agree. ...
I’m completing the requested read-only review now. I’ve confirmed one generated-reference contradiction; I’m checking whether the duplicated JSON-help examples are a compatibility defect and then I’ll return the required findings-first verdict.
No files found
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
55: * reads it to populate {@link CommandInfo.jsonFields}.
56: */
57: __jsonSchema?: import("valibot").GenericSchema;
58: /**
59: * Primary Stricli custom usage line, retained by `buildCommand` for
60: * introspection because Stricli does not expose it on the built command.
61: */
62: __primaryUsage?: string;
63: /** Canonical documentation examples retained by `buildCommand`. */
64: __examples?: readonly CommandExample[];
65: };
66:
67: /** Positional parameter definitions — either fixed-length tuple or variadic array */
68: export type PositionalParams =
69: | { kind: "tuple"; parameters: readonly PositionalParam[] }
70: | { kind: "array"; parameter: PositionalParam };
71:
72: /** A single positional parameter with optional brief and placeholder */
73: export type PositionalParam = {
74: brief?: string;
75: placeholder?: string;
76: ...
<skill_content name="jj-guide"> # Skill: jj-guide # jj Guide for AI Agents Jujutsu (jj) is a Git-compatible VCS with mutable commits, automatic snapshotting, no staging area, and first-class conflicts. This skill teaches you how to use it safely from a non-interactive agent environment. If `.jj/` exists in the repo root, this is a jj repo. **Use `jj` commands, not `git`.** In a colocated repo (`.jj/` *and* `.git/`), git tools can read the state, but mutations should go through `jj` so the operation log stays consistent. ## Critical Rules - **NEVER** use interactive flags (`-i`, `--interactive`). TUI prompts hang in agent environments. This applies to `jj split -i`, `jj squash -i`, `jj commit -i`, `jj resolve`, `jj diffedit`, etc. - **ALWAYS** pass `-m "msg"` when describing/committing. Without `-m`, an editor opens and hangs. - **VERIFY** mutations with `jj st` and `jj log` after `squash`, `abandon`, `rebase`, `restore`, `commit`. ...
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-project 3: version: 0.45.0-dev.0 4: description: Work with Sentry projects 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Project Commands 11: 12: Work with Sentry projects 13: 14: ### `sentry project create [<org>/]<name>:<platform>...` 15: 16: Create one or more projects 17: 18: **Flags:** 19: - `-t, --team <value> - Team to create the project under` 20: - `-n, --dry-run - Show what would happen without making changes` 21: 22: **Examples:** 23: 24: ```bash 25: # Every project is a name:platform pair; project names cannot contain whitespace 26: # Create a new project 27: sentry project create my-new-app:javascript-nextjs 28: 29: # Create several projects with their own platforms 30: sentry project create web:javascript api:python-django worker:node 31: 32: # Create under a specific ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
217: /**
218: * Extract structured positional parameter metadata from a command.
219: *
220: * Returns one entry per positional, with placeholder, brief, and whether
221: * the parameter is optional. Used by documentation generators to build
222: * argument tables.
223: *
224: * @param params - Stricli positional parameter definition
225: * @returns Array of positional info objects
226: */
227: export function extractPositionals(
228: params?: PositionalParams
229: ): PositionalInfo[] {
230: if (!params) {
231: return [];
232: }
233:
234: if (params.kind === "tuple") {
235: return params.parameters.map((p, i) => ({
236: placeholder: p.placeholder ?? `arg${i}`,
237: brief: p.brief ?? "",
238: optional: p.optional ?? false,
239: }));
240: }
241:
242: if (params.kind === "array") {
243: return [
244: {
245: ...
<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>
I’m completing the requested read-only review now. I’ll verify the current patch and report only defects introduced by it, with exact evidence and the required merge verdict.
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
No files found
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/help.test.ts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help.test.ts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-positional.test.ts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-json.test.ts /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/bench/helpers.test.ts
Found 19 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/utils.test.ts:
Line 14: describe("JSDoc examples (canonical alignment)", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/arg-parsing.test.ts:
Line 57: // Representative examples for documentation (invariants covered by property tests)
Line 325: // Representative examples for documentation (invariants covered by property tests)
Line 326: describe("representative examples", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/errors.test.ts:
Line 283: test("formats Try examples and Note section", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/issue-id.test.ts:
Line 58: describe("expandToFullShortId representative examples", () => {
Line 59: // Representative examples for documentation (invariants covered by property tests)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/dsn.test.ts:
Line 38: // All-zero ...
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: lines.push("|----------|-------------|");
157: for (const p of positionals) {
158: const syntax = p.optional ? `[<${p.placeholder}>]` : `<${p.placeholder}>`;
159: const placeholder = `\`${syntax}\``;
160: lines.push(`| ${placeholder} | ${escapeAngleBrackets(p.brief)} |`);
161: }
162: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-project 3: version: 0.45.0-dev.0 4: description: Work with Sentry projects 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Project Commands 11: 12: Work with Sentry projects 13: 14: ### `sentry project create [<org>/]<name>:<platform>...` 15: 16: Create one or more projects 17: 18: **Flags:** 19: - `-t, --team <value> - Team to create the project under` 20: - `-n, --dry-run - Show what would happen without making changes` 21: 22: **Examples:** 23: 24: ```bash 25: # Every project is a name:platform pair; project names cannot contain whitespace 26: # Create a new project 27: sentry project create my-new-app:javascript-nextjs 28: 29: # Create several projects with their own platforms 30: sentry project create web:javascript api:python-django worker:node 31: 32: # Create under a specific ...
/**
* 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 {
buildListCommand,
LIST_DEFAULT_LIMIT,
LIST_MAX_LIMIT,
LIST_MIN_LIMIT,
LIST_PERIOD_FLAG,
PERIOD_ALIASES,
paginationHint,
} from "../../lib/list-command.js";
import { withProgress } from "../../lib/polling.js";
import { resolveOrg } from "../../lib/resolve-target.js";
import {
appendPeriodHint,
...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -17,6 +17,7 @@ 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 { getPositionalString } from "../../lib/introspect.js";
import {
buildListCommand,
LIST_DEFAULT_LIMIT,
@@ -60,6 +61,18 @@ type ConversationListResult = {
const COMMAND_NAME = "agent-conversation list";
const PAGINATION_KEY = "agent-conversation-list";
const DEFAULT_PERIOD = "7d";
+const POSITIONAL = {
+ kind: "tuple",
+ parameters: [
+ {
+ placeholder: "org",
+ brief: "Organization slug",
+ parse: String,
+ ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 417: * Appends available field names and types to `fullDescription` so they appear
Line 433: const baseFull = docs.fullDescription ?? docs.brief;
Line 436: fullDescription: `${baseFull}\n\n${jsonFieldsDoc}`,
Line 454: fullDescription: `${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}`,
Line 466: metadata.__primaryUsage =
Line 470: metadata.__examples = docs.examples;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 37: fullDescription?: string;
Line 46: fullDescription?: string;
Line 62: __primaryUsage?: string;
Line 64: __examples?: readonly CommandExample[];
Line 105: fullDescription?: string;
Line 298: fullDescription: cmd.fullDescription,
Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
Line ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
90: /**
91: * Generate the commands list dynamically from Stricli's route structure.
92: * This ensures help text stays in sync with actual registered commands.
93: */
94: function generateCommands(): HelpCommand[] {
95: // Cast to our introspection types — Stricli's generic types are compatible
96: const routeMap = routes as unknown as RouteMap;
97: const entries = routeMap.getAllEntries();
98:
99: return entries
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible subcommand names and join with pipes
107: const subEntries = entry.target
108: .getAllEntries()
109: .filter((sub: RouteMapEntry) => !sub.hidden);
110: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
217: /**
218: * Extract structured positional parameter metadata from a command.
219: *
220: * Returns one entry per positional, with placeholder, brief, and whether
221: * the parameter is optional. Used by documentation generators to build
222: * argument tables.
223: *
224: * @param params - Stricli positional parameter definition
225: * @returns Array of positional info objects
226: */
227: export function extractPositionals(
228: params?: PositionalParams
229: ): PositionalInfo[] {
230: if (!params) {
231: return [];
232: }
233:
234: if (params.kind === "tuple") {
235: return params.parameters.map((p, i) => ({
236: placeholder: p.placeholder ?? `arg${i}`,
237: brief: p.brief ?? "",
238: optional: p.optional ?? false,
239: }));
240: }
241:
242: if (params.kind === "array") {
243: return [
244: {
245: ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,212 +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 { ...
<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: ...
I’ve isolated the confirmed cross-surface defect. I’m checking whether the JSON-help duplication is a second compatibility regression or only intentional native-help rendering, then I’ll issue the required findings-first verdict.
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
Found 34 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 484: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 130: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts: Line 384: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 575: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/send-envelope.ts: Line 26: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/schema.ts: Line 324: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/view.ts: Line 360: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/react-native/xcode.ts: Line 491: kind: ...
No files found
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts index cdc8865be..8c9ce6332 100644 --- a/packages/cli/script/generate-command-docs.ts +++ b/packages/cli/script/generate-command-docs.ts @@ -1,67 +1,68 @@ #!/usr/bin/env tsx /** * Generate Command Reference & Configuration Documentation * * Introspects the CLI's route tree and env var registry to generate * accurate reference pages for the documentation website. Flags, arguments, * aliases, and environment variables are extracted directly from source code, * preventing documentation drift. * * Each generated page combines: - * 1. Auto-generated reference — from CLI metadata or env registry - * 2. Hand-written fragment — examples, guides, tips (from docs/src/fragments/) + * 1. Auto-generated reference and examples from CLI metadata or env registry + * 2. Hand-written guides and tips from docs/src/fragments/ * * The generated output is gitignored. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. */
100: readonly description: string;
101: /** Complete command line, including the `sentry` executable. */
102: readonly command: string;
103: };
104:
105: /**
106: * Native Stricli documentation plus metadata for generated docs. When
107: * `customUsage` is present, its first line is the canonical signature suffix;
108: * later lines may document equivalent forms. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
410: ...FIELDS_FLAG,
411: brief: `${FIELDS_FLAG.brief}. Available: ${fieldNames}`,
412: };
413: }
414:
415: /**
416: * Enrich command docs with a JSON fields section when a schema is registered.
417: * Appends available field names and types to `fullDescription` so they appear
418: * in Stricli's `--help` output.
419: */
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
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,398 +1,408 @@
/**
* 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-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/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
I’m completing the requested read-only review now. I’ll validate the two cross-surface defects against current source, base behavior, and focused output, then return the required findings-first verdict.
No files found
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_0853c421f001xF7505H1rSM7Y1
// On a fresh checkout the file won't exist, causing a module resolution
// error. Write a minimal stub so the import resolves; the real content
// is generated at the end of this script.
// NOTE: This must run before the dynamic import() below because static
// imports are hoisted by the runtime before any code executes.
const SKILL_CONTENT_PATH = "src/generated/skill-content.ts";
if (!existsSync(SKILL_CONTENT_PATH)) {
mkdirSync("src/generated", { recursive: true });
writeFileSync(
SKILL_CONTENT_PATH,
"export const SKILL_FILES: ReadonlyMap<string, string> = new Map();\n"
);
}
@@ -577,47 +578,43 @@ function generateFullCommandDoc(cmd: CommandInfo): string {
lines.push(`- \`${formatFlag(flag, cmd.aliases)}\``);
}
}
if (cmd.jsonFields && cmd.jsonFields.length > 0) {
lines.push("");
lines.push(
"**JSON ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help-json.ts
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts: Line 22: extractAllRoutes, Line 354: routes: extractAllRoutes(routeMap), /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts: Line 25: fullDescription:
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
300: */
301: export type HelpJsonResult =
302: | {
303: routes: RouteInfo[];
304: envVars: HelpEnvVarInfo[];
305: flags: HelpFlagInfo[];
306: }
307: | CommandInfo
308: | RouteInfo
309: | { error: string; suggestions?: string[] };
310:
311: /**
312: * Build the top-level env-var list for JSON output.
313: *
314: * Exposes exactly the entries marked `topLevel` in the registry so that
315: * consumers (AI agents, docs tooling) can surface them without having to
316: * re-parse the CLI's branded help.
317: */
318: function buildTopLevelEnvVars(): HelpEnvVarInfo[] {
319: return TOP_LEVEL_ENV_VARS.map((v) => ({
320: name: v.name,
321: brief: v.briefDescription ?? v.description.split("\n")[0] ?? "",
322: description: v.description,
323: example: v.example,
324: defaultValue: v.defaultValue,
325: }));
326: }
327:
328: ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
35: export type RouteMap = {
36: brief: string;
37: fullDescription?: string;
38: getAllEntries: () => RouteMapEntry[];
39: /** Returns the default command if one is configured, undefined otherwise */
40: getDefaultCommand?: () => unknown;
41: };
42:
43: /** A leaf command with parameters */
44: export type Command = {
45: brief: string;
46: fullDescription?: string;
47: parameters: {
48: positional?: PositionalParams;
49: flags?: Record<string, FlagDef>;
50: aliases?: Record<string, string>;
51: };
52: /**
53: * JSON output schema attached by `buildCommand` when `output.schema` is set.
54: * Non-standard property — Stricli doesn't know about it, but introspection
55: * reads it to populate {@link CommandInfo.jsonFields}.
56: */
57: __jsonSchema?: import("valibot").GenericSchema;
58: /**
59: * Primary Stricli custom usage ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
90:
91: // ---------------------------------------------------------------------------
92: // Markdown Formatting
93: // ---------------------------------------------------------------------------
94:
95: /**
96: * Get visible, non-global flags for a command.
97: * Excludes hidden flags and globally-injected flags (--json, --fields, etc.).
98: */
99: function getVisibleFlags(cmd: CommandInfo): FlagInfo[] {
100: return cmd.flags.filter((f) => !(f.hidden || GLOBAL_FLAG_NAMES.has(f.name)));
101: }
102:
103: /**
104: * Format a flag as a table row: `| -q, --query <query> | Search query ... |`
105: *
106: * Uses the flag name as the value placeholder for readability
107: * (e.g., `--limit <limit>` instead of `--limit <value>`). ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
620: " sentry project create my-app:node\n" +
621: " sentry project create acme-corp/my-app:javascript-nextjs\n" +
622: " sentry project create web:javascript api:python-django worker:node\n" +
623: " sentry project create my-app:python-django --team backend\n" +
624: " sentry project create my-app:go --json",
625: },
626: output: {
627: human: formatProjectCreateOutput,
628: jsonExclude: [
629: "slugDiverged",
630: "expectedSlug",
631: "teamSource",
632: "requestedPlatform",
633: ],
634: },
635: parameters: {
636: positional: {
637: kind: "array",
638: parameter: {
639: placeholder: "name:platform",
640: brief: "One or more project name and platform pairs",
641: parse: String,
642: },
643: },
644: flags: {
645: team: {
646: ...
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
@@ -57,86 +57,98 @@ import {
} from "./formatters/output.js";
import { isPlainOutput } from "./formatters/plain-detect.js";
import { GLOBAL_FLAGS } from "./global-flags.js";
import { setInteractivePromptsAllowed } from "./interactive-prompts.js";
import {
LOG_LEVEL_NAMES,
type LogLevelName,
logger,
parseLogLevel,
setLogLevel,
} from "./logger.js";
import { setArgsContext, setFlagContext, withTracing } from "./telemetry.js";
/**
* Parse a string input as a number.
* Re-exported from Stricli for convenience. ...
I have two reproducible cross-surface regressions. I’m checking the focused tests and current line evidence now, then I’ll issue the merge verdict.
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
@@ -216,98 +216,101 @@ function getMultiCommandRoutes(): Map<string, RouteInfo> {
/**
* Given a route map target, find the name of its default command (if any).
* Compares the default command object reference against all subcommand entries.
*/
function findDefaultInRouteMap(target: RouteMap): string | undefined {
if (!target.getDefaultCommand) {
return;
}
const defaultCmd = target.getDefaultCommand();
if (!defaultCmd) {
return;
}
for (const sub of target.getAllEntries()) {
if (sub.target === defaultCmd) {
return sub.name.original;
}
}
return;
}
/**
* Extract the default command name for a route by inspecting the Stricli route map.
* Returns the default command name (e.g., "serve" for `local`) or undefined. ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 555b1f677..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,212 +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 { ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. */
98: export type CommandExample = {
99: /** Short explanation rendered before the command. */
100: readonly description: string;
101: /** Complete command line, including the `sentry` executable. */
102: readonly command: string;
103: };
104:
105: /**
106: * Native Stricli documentation plus metadata for generated docs. ...
<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/src/lib/introspect.ts</path>
<type>file</type>
<content>
185: // ---------------------------------------------------------------------------
186: // Extraction Functions
187: // ---------------------------------------------------------------------------
188:
189: /**
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
<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: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
275: hidden: def.hidden ?? false,
276: }));
277: }
278:
279: /**
280: * Build a {@link CommandInfo} from a Stricli Command.
281: *
282: * @param cmd - The Stricli command to introspect
283: * @param path - Full command path (e.g. "sentry issue list")
284: * @param examples - Optional usage examples
285: */
286: export function buildCommandInfo(
287: cmd: Command,
288: path: string,
289: examples: string[] = []
290: ): CommandInfo {
291: const jsonFields = cmd.__jsonSchema
292: ? extractSchemaFields(cmd.__jsonSchema)
293: : undefined;
294:
295: return {
296: path,
297: brief: cmd.brief,
298: fullDescription: cmd.fullDescription,
299: flags: extractFlags(cmd.parameters.flags),
300: positional:
301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
302: positionals: ...
I’m finishing the review against the unchanged bbaa7b3b… worktree. One contradiction is confirmed; I’m tracing the remaining metadata paths and tests before issuing the required findings-first verdict.
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-json.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Unit tests for {@link renderJsonHelp}, the pluggable help renderer wired into
3: * Stricli's `documentation.renderHelp` hook (see `app.ts`).
4: *
5: * End-to-end behavior through the real `app` (routing + the patch) lives in
6: * `scanner-flags.integration.test.ts`. These tests pin the pure input→output
7: * contract of the renderer: which top-level-flag combinations produce JSON,
8: * how the route prefix maps to introspection, and `--fields` narrowing.
9: */
10:
11: import { describe, expect, test } from "vitest";
12: import {
13: isRecoverableUnknownCommand,
14: isVersionRequest,
15: renderJsonHelp,
16: rewriteHelpJsonToHelpCommand,
17: } from "../../src/lib/help.js";
18:
19: const APP = "sentry";
20:
21: describe("renderJsonHelp", () => {
22: test("returns undefined without --json so text help is used", () => {
23: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: /**
218: * Extract ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 68: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
Found 8 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts: Line 122: entry.target.__primaryUsage ?? /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts: Line 62: __primaryUsage?: string; Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional), /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]; Line 466: metadata.__primaryUsage = /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts: Line 609: customUsage: ["[<org>/]<name>:<platform>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 63: customUsage: [USAGE],
Skill "repo-setup" not found. Available skills: ast-grep, customize-opencode, jj-create-pr, jj-guide, jj-update-pr, jj-workflow, sentry-cli
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs --import ./script/require-shim.mjs -e 'import { projectRoute } from "./src/commands/project/index.ts"; import { buildCommandInfo } from "./src/lib/introspect.ts"; const entries=(projectRoute as any).getAllEntries(); const create=entries.find((e:any)=>e.name.original==="create").target; console.log(JSON.stringify(buildCommandInfo(create,"sentry project create"),null,2));'
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
{
"path": "sentry project create",
"brief": "Create one or more projects",
"fullDescription": "Create Sentry projects in an organization.\n\nNames support org/name syntax to specify the organization explicitly.\nIf omitted, the org is auto-detected from config defaults. Project names\ncannot contain whitespace.\n\nEvery project is a name:platform pair. ...
I recovered the exact review contract. I’m now validating the two suspected regressions against both HEAD and the generated surfaces, then I’ll return the findings-first MERGE/DO-NOT-MERGE report without touching the worktree.
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -186,128 +186,131 @@ function fragmentMentionsSubcommand(
const proseOnly = stripCodeBlocks(content);
const escapedLeaf = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
const headingRe = new RegExp(`^#{1,4}\\s+.*\\b${escapedLeaf}\\b`, "im");
if (headingRe.test(proseOnly)) {
return true;
}
return false;
}
/**
* Build a map of route name → RouteInfo for routes with multiple subcommands.
* Standalone commands (single command matching `sentry <name>`) are skipped
* since there's nothing to check — the fragment covers the whole command. ...
No files found
Found 5 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/init/tools/run-commands-spawn.mocked.test.ts:
Line 100: options: { shell: false, windowsVerbatimArguments: true },
Line 121: options: { shell: false, windowsVerbatimArguments: true },
Line 141: options: { shell: false, windowsVerbatimArguments: true },
Line 160: options: { shell: false, windowsVerbatimArguments: true },
Line 179: options: { shell: false, windowsVerbatimArguments: true },
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151:
152: const lines: string[] = [];
153: lines.push("**Arguments:**");
154: lines.push("");
155: lines.push("| Argument | Description |");
156: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
180: }
181:
182: /** Extract all code blocks from markdown */
183: function extractCodeBlocks(
184: markdown: string,
185: language?: string
186: ): { code: string; lang: string }[] {
187: const blocks: { code: string; lang: string }[] = [];
188: const pattern = new RegExp(CODE_BLOCK_REGEX.source, CODE_BLOCK_REGEX.flags);
189: let match = pattern.exec(markdown);
190: while (match !== null) {
191: const lang = match[1] || "";
192: const code = match[2].trim();
193: if (!language || lang === language) {
194: blocks.push({ code, lang });
195: }
196: match = pattern.exec(markdown);
197: }
198: return blocks;
199: }
200:
201: /** Escape special regex characters in a string */
202: function escapeRegex(str: string): string {
203: return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
204: }
205:
206: // ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts:
Line 28: formatCommandExamples,
Line 566: function generateFullCommandDoc(cmd: CommandInfo): string {
Line 598: const examples = formatCommandExamples(cmd.examples);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
530: /** Format a flag for display in documentation */
531: function formatFlag(flag: FlagInfo, aliases: Record<string, string>): string {
532: const parts: string[] = [];
533: const alias = Object.entries(aliases).find(([, v]) => v === flag.name)?.[0];
534: let syntax = `--${flag.name}`;
535: if (alias) {
536: syntax = `-${alias}, ${syntax}`;
537: }
538: if ((flag.kind === "parsed" || flag.kind === "enum") && !flag.variadic) {
539: syntax += " <value>";
540: } else if (flag.variadic) {
541: syntax += " <value>...";
542: }
543: parts.push(syntax);
544: if (flag.brief) {
545: parts.push(flag.brief);
546: }
547: if (flag.default !== undefined && flag.kind !== "boolean") {
548: parts.push(`(default: ${JSON.stringify(flag.default)})`);
549: }
550: return parts.join(" - ");
551: }
552:
553: /**
554: * Get the visible, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
40: getDefaultCommand?: () => unknown;
41: };
42:
43: /** A leaf command with parameters */
44: export type Command = {
45: brief: string;
46: fullDescription?: string;
47: parameters: {
48: positional?: PositionalParams;
49: flags?: Record<string, FlagDef>;
50: aliases?: Record<string, string>;
51: };
52: /**
53: * JSON output schema attached by `buildCommand` when `output.schema` is set.
54: * Non-standard property — Stricli doesn't know about it, but introspection
55: * reads it to populate {@link CommandInfo.jsonFields}.
56: */
57: __jsonSchema?: import("valibot").GenericSchema;
58: /**
59: * Primary Stricli custom usage line, retained by `buildCommand` for
60: * introspection because Stricli does not expose it on the built command.
61: */
62: __primaryUsage?: string;
63: /** Canonical documentation examples retained ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-project 3: version: 0.45.0-dev.0 4: description: Work with Sentry projects 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Project Commands 11: 12: Work with Sentry projects 13: 14: ### `sentry project create [<org>/]<name>:<platform>...` 15: 16: Create one or more projects 17: 18: **Flags:** 19: - `-t, --team <value> - Team to create the project under` 20: - `-n, --dry-run - Show what would happen without making changes` 21: 22: **Examples:** 23: 24: ```bash 25: # Every project is a name:platform pair; project names cannot contain whitespace 26: # Create a new project 27: sentry project create my-new-app:javascript-nextjs 28: 29: # Create several projects with their own platforms 30: sentry project create web:javascript api:python-django worker:node 31: 32: # Create under a specific ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md index ce3ed2f8f..960fe7fff 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md @@ -28,65 +28,65 @@ sentry project create my-new-app:javascript-nextjs # Create several projects with their own platforms sentry project create web:javascript api:python-django worker:node # Create under a specific org and team sentry project create my-org/my-new-app:python --team backend-team # Preview without creating sentry project create my-new-app:node --dry-run ``` ### `sentry project delete <org/project>` Delete a project **Flags:** - `-y, --yes - Skip confirmation prompt` - `-f, --force - Force the operation without confirmation` - `-n, --dry-run - Show what would happen without making changes` ...
<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/plugins/sentry-cli/skills/sentry-cli/references/project.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-project 3: version: 0.45.0-dev.0 4: description: Work with Sentry projects 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Project Commands 11: 12: Work with Sentry projects 13: 14: ### `sentry project create [<org>/]<name>:<platform>...` 15: 16: Create one or more projects 17: 18: **Flags:** 19: - `-t, --team <value> - Team to create the project under` 20: - `-n, --dry-run - Show what would happen without making changes` 21: 22: **Examples:** 23: 24: ```bash 25: # Every project is a name:platform pair; project names cannot contain whitespace 26: # Create a new project 27: sentry project create my-new-app:javascript-nextjs 28: 29: # Create several projects with their own platforms 30: sentry project create web:javascript api:python-django worker:node 31: 32: # Create under a specific ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
...output truncated...
Full output saved to: /home/byk/.local/share/opencode/tool-output/tool_0855e7dcb001PorpQXXdEphZ9Q
import { setArgsContext, setFlagContext, withTracing } from "./telemetry.js";
/**
* Parse a string input as a number.
* Re-exported from Stricli for convenience.
*/
export const numberParser = stricliNumberParser;
/** Base flags type from Stricli */
type BaseFlags = Readonly<Partial<Record<string, unknown>>>;
/** Base args type from Stricli */
type BaseArgs = readonly unknown[];
/**
* Type-erased Stricli builder arguments.
*
* At the `stricliCommand()` call site we've modified both `parameters`
* (injected hidden flags) and `func` (wrapped with telemetry/output
* logic), which breaks the original `FLAGS`/`ARGS` generic alignment
* that Stricli's `CommandBuilderArguments` enforces via `NoInfer`. ...
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/src/lib/command.ts</path>
<type>file</type>
<content>
80: type BaseArgs = readonly unknown[];
81:
82: /**
83: * Type-erased Stricli builder arguments.
84: *
85: * At the `stricliCommand()` call site we've modified both `parameters`
86: * (injected hidden flags) and `func` (wrapped with telemetry/output
87: * logic), which breaks the original `FLAGS`/`ARGS` generic alignment
88: * that Stricli's `CommandBuilderArguments` enforces via `NoInfer`.
89: *
90: * Rather than silencing with `as any`, we cast through `unknown` to
91: * this type that matches Stricli's structural expectations while
92: * erasing the generic constraints we can no longer satisfy.
93: */
94: type StricliBuilderArgs<CONTEXT extends CommandContext> =
95: import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
96:
97: /** A runnable example stored with a command definition for generated docs. ...
I’m validating the two suspected regressions against the rendered metadata and generated output, then I’ll give the review verdict.
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
590: }
591:
592: const { project, dsn, url } = projectDetails;
593: return {
594: project,
595: orgSlug,
596: teamSlug,
597: teamSource,
598: requestedPlatform: platform,
599: dsn,
600: url,
601: slugDiverged: project.slug !== expectedSlug,
602: expectedSlug,
603: };
604: }
605:
606: export const createCommand = buildCommand({
607: docs: {
608: brief: "Create one or more projects",
609: customUsage: ["[<org>/]<name>:<platform>..."],
610: fullDescription:
611: "Create Sentry projects in an organization.\n\n" +
612: "Names support org/name syntax to specify the organization explicitly.\n" +
613: "If omitted, the org is auto-detected from config defaults. Project names\n" +
614: "cannot contain whitespace.\n\n" +
615: "Every project is a name:platform pair. ...
## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
190: * Build a positional parameter placeholder string from Stricli positional params.
191: *
192: * @param params - Stricli positional parameter definition
193: * @returns Human-readable placeholder like `<target>` or `<command...>`
194: */
195: export function getPositionalString(params?: PositionalParams): string {
196: if (!params) {
197: return "";
198: }
199:
200: if (params.kind === "tuple") {
201: return params.parameters
202: .map((p, i) => {
203: const placeholder = `<${p.placeholder ?? `arg${i}`}>`;
204: return p.optional ? `[${placeholder}]` : placeholder;
205: })
206: .join(" ");
207: }
208:
209: if (params.kind === "array") {
210: const placeholder = params.parameter.placeholder ?? "args";
211: return `<${placeholder}...>`;
212: }
213:
214: return "";
215: }
216:
217: /**
218: * Extract ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts</path>
<type>file</type>
<content>
625: },
626: output: {
627: human: formatProjectCreateOutput,
628: jsonExclude: [
629: "slugDiverged",
630: "expectedSlug",
631: "teamSource",
632: "requestedPlatform",
633: ],
634: },
635: parameters: {
636: positional: {
637: kind: "array",
638: parameter: {
639: placeholder: "name:platform",
640: brief: "One or more project name and platform pairs",
641: parse: String,
642: },
643: },
644: flags: {
645: team: {
646: kind: "parsed",
647: parse: String,
648: brief: "Team to create the project under",
649: optional: true,
650: },
651: "dry-run": DRY_RUN_FLAG,
652: },
653: aliases: { ...DRY_RUN_ALIASES, t: "team" },
654: },
655: async *func(this: SentryContext, flags: CreateFlags, ...args: string[]) {
656: ...
<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>
* 🔴 (09:01) `packages/cli/src/commands/project/create.ts` configures `output.human` as `formatProjectCreateOutput` and `output.jsonExclude` as `["slugDiverged", "expectedSlug", "teamSource", "requestedPlatform"]`. * 🔴 (09:01) `packages/cli/src/commands/project/create.ts` defines `parameters.positional` with `kind: "array"` and a parameter using `placeholder: "name:platform"`, `brief: "One or mo…
* 🔴 (09:00) `packages/cli/src/lib/introspect.ts` defines `getPositionalString(params?: PositionalParams): string`: absent params return `""`; tuple params map to `<placeholder>` using fallback `arg${i}`, wrap optional entries as `[<placeholder>]`, and join with spaces; array params return `<${params.parameter.placeholder ?? "args"}...>`; unsupported kinds return `""`. * 🔴 (09:00) `packages/cli/…
* 🔴 (09:00) Git status showed branch `fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone]`, indicating its tracked remote branch was gone. * 🔴 (09:00) Working tree had 32 modified files: `apps/cli-docs/src/fragments/commands/agent-conversation.md`; `packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md`; reference files `packages/cli/plugins/sentry-cli/skills/sentry-cli/ref…
* 🔴 (08:58) File `/home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc` was not found. * 🔴 (08:59) User stated that `--dry-run` never actually creates the team in `packages/cli/src/commands/project/create.ts`. * 🔴 (08:59) In `packages/cli/src/commands/project/create.ts` lines 669–678, `teamAutoCreateSlug` is pinned before project creation so real runs and `--dry-run` previews agree…
* 🔴 (08:56) Code change in `packages/cli/script/check-fragments.ts`: the multi-command route coverage loop now skips any command where `cmd.examples.length > 0`, so fragment subcommand coverage is checked only for commands without canonical examples. * 🔴 (08:57) User’s command framework requires output hints to be placed on the async generator’s return value, never on individual yields. * 🔴 (0…
* 🔴 (08:54) User stated `--json` is always injected when a command defines `output: { human: ... }`. * 🔴 (08:54) User stated flags in `ALWAYS_STRIP` are always stripped before invocation, so the command never sees them; `ALWAYS_STRIP` contains `LOG_LEVEL_KEY`. * 🔴 (08:54) User stated list commands must always inject `--fresh` unless the command already defines a `fresh` flag. * 🔴 (08:54) User…
* 🔴 (08:52) User’s Git worktree was on branch `fix/agent-conversation-reference-root-cause`; its upstream `origin/pr-1558` was marked `[gone]`. * 🔴 (08:52) User’s worktree had 32 modified files with an aggregate diffstat of 331 insertions and 170 deletions. * 🔴 (08:52) Modified documentation/generated skill files were: `apps/cli-docs/src/fragments/commands/agent-conversation.md`, `packages/cli…
* 🔴 (08:50) User provided the complete 92-line generated reference file `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md`. * 🔴 (08:50) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md` has YAML frontmatter with `name: sentry-cli-project`, `version: 0.45.0-dev.0`, `descriptio…
* 🔴 (08:49) User provided the complete 316-line file `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts`, a `tsx` validation script for documentation fragments. * 🔴 (08:49) `packages/cli/script/check-fragments.ts` validates 5 conditions: 1. every CLI route has a corresponding command fragment plus `index.md`; 2. every command fragment corresponds to a route or `index.m…
* 🔴 (08:47) User-provided diff updates `packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md`: changes `sentry project list <org/project>` to `sentry project list [<org/project>]` and `sentry project view <org/project>` to `sentry project view [<org/project>]`, documenting `<org/project>` as optional for both commands.
* 🔴 (08:46) User-provided documentation file `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md` defines the `sentry-cli-project` skill, version `0.45.0-dev.0`, described as “Work with Sentry projects,” with `bins: ["sentry"]` and `auth: true`. * 🔴 (08:46) User-provided source documents `sentry project create [<org>/]<name>:<platform>..…
* 🔴 (08:45) User-provided source documentation states that streaming commands render each yield immediately, while output handling associated with the return value runs only on the return value—never on individual yields. * 🔴 (08:45) User-provided source defines `const LOG_LEVEL_KEY = "log-level"` and documents the injected `--log-level` flag as always stripped before the command function runs.…
* 🟡 (08:44) In `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts`, `Command` at lines 44-65 contains `brief`, optional `fullDescription`, `parameters` with optional `positional`, `flags`, and `aliases`, plus introspection-only metadata: `__jsonSchema?: import("valibot").GenericSchema`, `__primaryUsage?: string`, and `__examples?: readonly CommandExample[]`. * 🟡 (08:44) In…
* 🟡 (08:43) In `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts`, `formatFlag(flag: FlagInfo, aliases: Record<string, string>): string` at lines 531-550 finds the first alias whose mapped value equals `flag.name`, formats syntax as `-${alias}, --${flag.name}` or just `--${flag.name}`, appends ` <value>` for non-variadic `"parsed"`/`"enum"` flags or ` <value>...` for va…
* 🟡 (08:41) In `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts`, `extractCodeBlocks(markdown: string, language?: string)` at lines 183-199 clones `CODE_BLOCK_REGEX`, iterates over all matches, trims each block’s code, defaults a missing language to `""`, optionally filters by exact language equality, and returns `{ code, lang }[]`. * 🟡 (08:41) In `/home/byk/Code/gets…
* 🟡 (08:41) In `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts`, `escapeAngleBrackets(text: string)` at lines 142-144 replaces `<` with `<` and `>` with `>` so angle brackets render literally in HTML output. * 🟡 (08:41) In `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts`, `formatPositionalsTable(positionals: PositionalI…
* 🟡 (08:40) Search found 5 instances of `options: { shell: false, windowsVerbatimArguments: true },` in `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/init/tools/run-commands-spawn.mocked.test.ts`, at lines 100, 121, 141, 160, and 179.
* 🟡 (08:39) Review diff included changes in `packages/cli/script/check-fragments.ts`, including route-aware fragment validation helpers: `getMultiCommandRoutes()`, `findDefaultInRouteMap(target: RouteMap)`, and `getDefaultCommandName(routeName: string)`. Standalone routes are skipped when they have at most one command whose path is exactly `sentry ${route.name}`; default subcommands are identifi…
* 🟡 (08:38) Introspected `projectRoute` from `./src/commands/project/index.ts` with `buildCommandInfo` from `./src/lib/introspect.ts`, targeting `sentry project create`, via `tsx` in `/home/byk/Code/getsentry/cli-pr-1558/packages/cli`; command included duplicate `--import ./script/require-shim.mjs` arguments. `.env.local` was not found, and execution continued without it; the warning appeared tw…
* 🟡 (08:37) Attempt to load skill `repo-setup` failed because it was not found. Available skills were: `ast-grep`, `customize-opencode`, `jj-create-pr`, `jj-guide`, `jj-update-pr`, `jj-workflow`, and `sentry-cli`. * 🟡 (08:37) Located the agent conversation reference at `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md`.
* 🔴 (08:36) Search found exactly 8 matches for `__primaryUsage` / `customUsage`: `packages/cli/src/lib/help.ts` line 122 (`entry.target.__primaryUsage ??`); `packages/cli/src/lib/introspect.ts` line 62 (`__primaryUsage?: string;`) and line 301 (`cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),`); `packages/cli/src/lib/command.ts` line 107 (comment: `` `customUsage` is presen…
* 🔴 (08:35) Search found exactly 2 `examples:` matches: `packages/cli/src/commands/agent-conversation/view.ts` at line 68 and `packages/cli/src/commands/agent-conversation/list.ts` at line 117.
* 🔴 (08:35) `packages/cli/src/lib/introspect.ts` defines `getPositionalString(params?: PositionalParams): string` at lines 195–215 to build human-readable positional placeholders from Stricli positional definitions. * 🔴 (08:35) `getPositionalString()` returns `""` when `params` is absent or its kind is unsupported. * 🔴 (08:35) For `params.kind === "tuple"`, `getPositionalString()` maps paramet…
* 🔴 (08:33) `packages/cli/test/lib/help-json.test.ts` contains 27 Vitest unit tests for `renderJsonHelp`, `rewriteHelpJsonToHelpCommand`, `isVersionRequest`, and `isRecoverableUnknownCommand`, imported from `../../src/lib/help.js`; the tests use `const APP = "sentry"`. * 🔴 (08:33) The `renderJsonHelp` suite documents the pure input→output contract of the renderer wired into Stricli’s `documenta…
* 🔴 (08:32) `packages/cli/src/lib/command.ts` adds exported type `CommandExample` with readonly `description: string` (short explanation rendered before the command) and readonly `command: string` (complete command line including the `sentry` executable). * 🔴 (08:32) `packages/cli/src/lib/command.ts` changes `CommandDocumentation` from a private alias of `StricliBuilderArgs<CommandContext>["doc…
* 🔴 (08:31) `packages/cli/src/lib/introspect.ts` lines 286-311 define `buildCommandInfo(cmd: Command, path: string, examples: string[] = []): CommandInfo`; it extracts `jsonFields` from `cmd.__jsonSchema` via `extractSchemaFields()`, then returns `path`, `brief`, `fullDescription`, flags from `extractFlags(cmd.parameters.flags)`, `positional` from `cmd.__primaryUsage ?? getPositionalString(cmd.p…
* 🔴 (08:30) `packages/cli/package.json` defines package `sentry` version `0.45.0-dev.0`, described as “Sentry CLI - A command-line interface for using Sentry built by robots and humans for robots and humans”; repository is `git+https://github.com/getsentry/cli.git`, license is `FSL-1.1-Apache-2.0`, and package type is `module`. * 🔴 (08:30) `packages/cli/package.json` uses `./dist/index.cjs` as …
* 🔴 (08:29) In `packages/cli/script/generate-command-docs.ts`, `escapeAngleBrackets(text)` replaces `<` with `<` and `>` with `>` so literal angle brackets are not interpreted as HTML. * 🔴 (08:29) In `packages/cli/script/generate-command-docs.ts`, `formatPositionalsTable(positionals)` returns `""` for no positionals; otherwise it emits an `**Arguments:**` Markdown table in input order. Re…
* 🔴 (08:27) `SentryCommandFunction` command functions are async generators: non-streaming commands yield one `CommandOutput<T>` and may return `{ hint }`; streaming commands render each yield immediately; commands supporting `--json` must yield one aggregate value when callers need one parseable JSON document because individual JSON chunks are pretty-printed rather than JSONL; void commands may …
* 🔴 (08:26) Property test asserts `extractFlags(flags)` always returns exactly one `FlagInfo` per input entry: `result` length equals `Object.keys(flags).length`. * 🔴 (08:26) `getPositionalString()` tuple output always uses angle-bracket placeholders; each parameter renders as `<${placeholder}>` when required or `[<${placeholder}>]` when `parameter.optional` is true, with fallback placeholder `…
* 🔴 (08:24) `packages/cli/script/check-fragments.ts` adds `findDefaultInRouteMap(target: RouteMap): string | undefined`, which identifies a route map’s default command by comparing `target.getDefaultCommand()` by object reference against `target.getAllEntries()` and returning the matching `sub.name.original`. * 🔴 (08:24) `packages/cli/script/check-fragments.ts` adds `getDefaultCommandName(route…
* 🔴 (08:22) In `packages/cli/src/lib/command.ts`, `CommandExample` is exported with readonly `description` and readonly `command`; `command` is a complete command line including the `sentry` executable. * 🔴 (08:22) In `packages/cli/src/lib/command.ts`, `CommandDocumentation` is exported as Stricli’s native command documentation extended with optional `readonly examples?: readonly CommandExample…
* 🔴 (08:22) In `packages/cli/src/commands/project/create.ts`, `sentry project create` examples are: `sentry project create my-app:node`, `sentry project create acme-corp/my-app:javascript-nextjs`, `sentry project create web:javascript api:python-django worker:node`, `sentry project create my-app:python-django --team backend`, and `sentry project create my-app:go --json`. * 🔴 (08:22) In `package…
* 🔴 (08:20) `packages/cli/script/generate-command-docs.ts` defines `getVisibleFlags(cmd: CommandInfo): FlagInfo[]`, filtering out flags where `f.hidden` is true or `GLOBAL_FLAG_NAMES` contains `f.name`; this excludes hidden and globally injected flags such as `--json` and `--fields`. * 🔴 (08:20) `formatFlagRow(flag: FlagInfo, aliases: Record<string, string>): string` finds the first alias whose…
* 🔴 (08:19) `packages/cli/src/lib/introspect.ts` defines `RouteMap` with `brief`, optional `fullDescription`, `getAllEntries(): RouteMapEntry[]`, and optional `getDefaultCommand(): unknown`. * 🔴 (08:19) `packages/cli/src/lib/introspect.ts` defines `Command` with `brief`, optional `fullDescription`, positional/flag/alias parameters, and introspection-only metadata: `__jsonSchema?: import("valibo…
* 🔴 (08:18) Git status showed branch `fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone]`, indicating its upstream `origin/pr-1558` no longer exists. * 🔴 (08:18) Working tree had 32 modified files: `apps/cli-docs/src/fragments/commands/agent-conversation.md`; `packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md`; reference files `alert.md`, `cli.md`, `explore.md`, `feedb…
* 🔴 (08:16) Tool result reported file not found at `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help-json.ts`. * 🔴 (08:16) Search found 3 matches: `extractAllRoutes` imported at line 22 and used in `routes: extractAllRoutes(routeMap)` at line 354 of `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts`; `fullDescription` occurs at line 25 of `/home/byk/Code/getsentry…
* 🔴 (08:16) User-provided code states flags in `ALWAYS_STRIP` are always stripped and the command never sees them; `ALWAYS_STRIP = new Set([LOG_LEVEL_KEY])` in `packages/cli/src/lib/command.ts`. * 🔴 (08:16) User-provided code requires always injecting `--fresh` unless the command already defines it; implementation checks `if (!("fresh" in mergedFlags))` before assigning `mergedFlags.fresh = FRE…
* 🔴 (08:14) User stated agent conversation IDs are org-scoped, not org/project-scoped like trace/replay IDs, and never contain `/`. * 🔴 (08:14) `packages/cli/src/commands/agent-conversation/view.ts` defines `USAGE = "[<org>/]<conversation-id>"` and `USAGE_HINT = \`sentry agent-conversation view ${USAGE}\``. * 🔴 (08:14) `parseConversationTarget(target: string)` trims the target and splits on th…
* 🔴 (08:13) `packages/cli/script/generate-skill-markdown.ts` defines `COMMAND_HEADING_RE` as `/^`sentry\s+([^<[`\s]+(?:\s+[^<[`\s]+)*)(?:\s*(?:<|\[)[^`]*)?`$/` to match generated command headings while excluding positional usage. * 🔴 (08:13) `extractCommandPathFromHeading(heading: string): string | undefined` in `packages/cli/script/generate-skill-markdown.ts` extracts the literal command path …
* 🔴 (08:12) `packages/cli/src/lib/introspect.ts` now imports `CommandExample` from `./command.js` and adds `Command.__examples?: readonly CommandExample[]` for canonical documentation examples retained by `buildCommand`. * 🔴 (08:12) `buildCommandInfo()` in `packages/cli/src/lib/introspect.ts` now prefers nonempty `cmd.__examples` over its legacy `examples: string[]` argument. Each structured `{…
* 🔴 (08:08) User asserted the command-output invariant in `packages/cli/src/lib/command.ts`: hints live exclusively on the `CommandReturn` return value, never on individual yields. * 🔴 (08:08) `packages/cli/src/lib/command.ts` defines `CommandExample` with readonly `description: string` and readonly `command: string`; the command must include the `sentry` executable. * 🔴 (08:08) `CommandDocume…
* 🔴 (08:07) A file search returned exactly `No files found`. * 🔴 (08:08) User asserted the `getPositionalString` tuple invariant: it always produces angle-bracket placeholders. * 🔴 (08:08) User asserted the `getPositionalString` array invariant: it always includes an ellipsis (`...`). * 🔴 (08:08) User asserted the `extractAllRoutes` invariant: it never includes hidden entries. * 🔴 (08:08) A …
* 🟡 (08:06) Assistant reported isolating a confirmed cross-surface defect and began checking whether JSON-help duplication was a second compatibility regression or intentional native-help rendering before giving a findings-first verdict. * 🔴 (08:06) Generated documentation in `apps/cli-docs/src/content/docs/commands/project.md` shows `sentry project create [<org>/]<name>:<platform>...` at line …
* 🔴 (08:05) In `packages/cli/src/commands/agent-conversation/list.ts`, the agent-conversation list command now imports `getPositionalString` from `../../lib/introspect.js`. * 🔴 (08:05) The agent-conversation list command replaced `customUsage: ["[<org>]"]` with shared positional metadata via `positional: POSITIONAL`; its examples were migrated from an embedded `"Examples:\n"` string to structur…
* 🔴 (08:03) `packages/cli/src/lib/help.ts` function `generateCommands(): HelpCommand[]` casts `routes` to `RouteMap`, calls `routeMap.getAllEntries()`, filters out entries where `entry.hidden` is true, and maps each visible entry into a help command. * 🔴 (08:03) For route-map entries, `generateCommands()` filters out hidden subcommands, joins visible `sub.name.original` values with `" | "`, and…
* 🔴 (07:59) Generated skill reference `packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md` has front matter `name: sentry-cli-project`, `version: 0.45.0-dev.0`, description `Work with Sentry projects`, requires binary `sentry`, and requires authentication. * 🔴 (07:59) `project.md` documents `sentry project create [<org>/]<name>:<platform>...` with flags `-t, --team <value>`…
* 🔴 (07:53) Repository root is `/home/byk/Code/getsentry/cli-pr-1558`; its 18 entries are `.craft.yml`, `.git`, `.github/`, `.gitignore`, `.lore.md`, `.nojekyll`, `.npmrc`, `AGENTS.md`, `apps/`, `CHANGELOG.md`, `codemods/`, `LICENSE.md`, `node_modules/`, `package.json`, `packages/`, `pnpm-lock.yaml`, `pnpm-workspace.yaml`, and `README.md`. * 🟡 (07:53) Assistant stated it was performing a read-o…
* 🔴 (07:50) User-provided `packages/cli/src/lib/command.ts` defines every `SentryCommandFunction` as an async generator: non-streaming commands yield one `CommandOutput<T>` and may return `{ hint }`; streaming yields render immediately; `--json` commands must yield one aggregate value when callers need one parseable JSON document because chunks are pretty-printed rather than JSONL; void commands…
* 🔴 (07:46) User-provided diff changes `packages/cli/script/check-fragments.ts`: while checking multi-command routes, commands with `cmd.examples.length > 0` now `continue`, so a command-owned example satisfies the examples requirement without a hand-written fragment. * 🔴 (07:46) User-provided diff updates `packages/cli/script/generate-command-docs.ts` documentation architecture: generated page…