Distillation

Date: Sep 9, 2026

• 🟡 (23:12) Patch deletes the contents of apps/cli-docs/src/fragments/commands/agent-conversation.md, leaving the file empty (e69de29bb).
• 🟡 (23:12) A new buildCommand() test, retains structured examples for introspection, verifies that command documentation examples remain available through __examples; the fixture preserves { description: "Select an organization explicitly", command: "sentry thing list my-org" }.
• 🟡 (23:12) Existing command-wrapper tests verify that numberParser is re-exported from Stricli and is a function, and that string defaults are passed through parse() so a numberParser default is a number at runtime.
• 🔴 (23:12) User-provided property test states extractFlags() always returns exactly one FlagInfo per input entry, checked with Object.keys(flags).length over flagsMapArb and DEFAULT_NUM_RUNS.
• 🔴 (23:12) User-provided property test states tuple positional parameters always produce angle-bracket placeholders through getPositionalString(); required parameters render as <placeholder>, optional parameters render as [<placeholder>], and an absent placeholder falls back to arg${index}.
• 🔴 (23:12) User-provided property test states array positional parameters always include an ellipsis (...) in the output of getPositionalString().
• 🔴 (23:12) User-provided property test states resolveCommandPath(routeMap, []) always returns null for an empty path.
• 🟡 (23:12) The extractFlags() parsed-flag test expects the limit definition { kind: "parsed", brief: "Max items", default: 25, optional: false } to produce exactly { name: "limit", brief: "Max items", kind: "parsed", default: 25, optional: false, variadic: false, hidden: false }.
• 🟡 (23:12) extractCommandPathFromHeading() tests map: 1. `sentry issue view <issue-id>` → sentry issue view; 2. `sentry project create [<org>/]<name>:<platform>...` → sentry project create; 3. `sentry auth status` → sentry auth status.
• 🟡 (23:12) Generated agent-conversation reference content is expected to include the example # View full transcript (organization auto-detected)\nsentry agent-conversation view conv-123.
• 🔴 (23:12) User stated a project platform must always be attached to the project name with : and must not use a space-separated form.
• 🟡 (23:12) Project-create reference tests require the heading ### \sentry project create [<org>/]<name>:<platform>...`, reject sentry project create "My New App":, reject both sentry project create my-new-app javascript-nextjsandsentry project create my-org/my-new-app javascript-nextjs, and require examples sentry project create web:javascript api:python-django worker:nodeandsentry project create my-new-app:javascript-nextjs`.
• 🟡 (23:12) User-provided Python artifact defines a small GitHub REST client with GITHUB_API = "https://api.github.com", GitHubError(RuntimeError), immutable RepoRef, and GitHubClient.
• 🟡 (23:12) RepoRef.parse(value) trims and splits on /, requires exactly two nonempty components, and raises ValueError(f"repo must look like owner/name, got {value!r}") otherwise; slug returns owner/name, while path_slug returns owner__name.
• 🟡 (23:12) GitHubClient.__init__() accepts token, api_url, sleep_seconds, and max_retries; defaults are GITHUB_API, 0.0, and 3, while authentication falls back from the explicit token to GITHUB_TOKEN and then GH_TOKEN.
• 🟡 (23:12) GitHubClient.request_json() JSON-encodes payloads as UTF-8, returns appropriately decoded API responses, recognizes GitHub rate limiting, may wait until X-RateLimit-Reset, and uses exponential retry sleeps of 2**attempt for retryable failures.
• 🟡 (23:12) GitHub request errors include the URL and response details: HTTP failures raise GitHubError(f"GitHub API {exc.code} for {url}: {body}{reset_text}"), while transport failures raise GitHubError(f"GitHub API request failed for {url}: {exc}").
• 🟡 (23:12) GitHubClient.get_pull_request(repo, number) performs a request to /repos/{repo.owner}/{repo.name}/pulls/{number}.
• 🟡 (23:12) GitHubClient.search_issues_count(query) requests /search/issues with { "q": query, "per_page": 1 } and returns integer total_count, defaulting to 0.
• 🟡 (23:12) GitHubClient.remove_issue_label(repo, number, label) URL-encodes the label using urllib.parse.quote(label, safe=""), sends DELETE to /repos/{owner}/{name}/issues/{number}/labels/{encoded_label}, suppresses GitHubError only when its text contains GitHub API 404, and re-raises other errors.
• 🟡 (23:12) GitHubClient._is_rate_limited() only considers HTTP 403 and 429; it returns true when X-RateLimit-Remaining == "0" or when the response body contains rate limit case-insensitively.
• 🟡 (23:12) normalize_label() preserves name, color, and description.
• 🟡 (23:12) The PR-normalization artifact emits schema_version: 1 and preserves PR metadata including id, state, body defaulting to "", closed_at, requested reviewers, base/head data, head repository full_name, and numeric counters such as additions and comments defaulting to 0.
• 🟡 (23:12) normalize_file(file_info) returns filename, status, additions, deletions, changes, previous_filename, and patch; all three numeric change fields default to 0.