docs: document completion and custom endpoint settings keys (+ missing_docs bookkeeping for v0.2026.08.26)

.agents/skills/missing_docs/references/changelog_decisions.md

@@ -32,6 +32,46 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it
 
 | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome |
 |---|---|---|---|---|
+| ShellWidgetHandoff (flag added, preview) | 2026-09-02 | deferred | Gate 0 | New preview-status feature flag (`PREVIEW_FLAGS` in `crates/warp_features/src/lib.rs`; cargo bridge `shell_widget_handoff` in `app/src/features.rs`). Hands Ctrl+R history search off to the shell's own widget (fzf or atuin) instead of Warp's command search. Not GA, so not documentable. Added to the surface-map ignore list with the other pre-launch toggles; snapshot diff re-flags on promotion or removal. Re-check on promotion to GA. |
+| POST /factory/{uid}/integrations/linear/handoff | 2026-09-02 | deferred | Gate 0 | Hands a Linear issue to the factory from the integrations test-connections flow (`CreateFactoryLinearTaskHandoffHandler` in `router/handlers/public_api/factories.go`, added by warp-server #16352). Inside the unreleased `/factory` namespace that sync-openapi-spec excludes; released OpenAPI (`developers/agent-api-openapi.yaml`) still has zero `/factory` paths. Mapped `-> internal`. Re-check when the factory API is published. |
+| n/a ("Warp AI credits" in live inference prose, 2026-09-02 exhaustive re-run) | 2026-09-02 | yes | Staleness: renamed product name in prose | Corrects the prior bulk staleness verdicts, which classified every `warp ai` hit as a telemetry event name or a historical reference. Three occurrences are neither: `agents/inference/custom-inference-endpoint.mdx` (the `### Warp AI credits` heading and the sentence under it) and `agents/inference/bring-your-own-api-key.mdx:100` name the inference credit bucket as "Warp AI credits", embedding the retired **Warp AI** product name. Canonical bucket name is **AI credits** (`plans-and-billing/credits.md:16`). Renamed to "AI credits" on both pages; no page links the old `#warp-ai-credits` anchor. The remaining `Warp AI` hits (telemetry event names in `privacy.mdx`, the historical FAQ heading) stay as-is. |
+| n/a (82 --weak-coverage feature findings, 2026-09-02 re-run) | 2026-09-02 | no | Disqualified: not a docs gap / heuristic false positive | Re-ran `--weak-coverage` for exhaustiveness. Same 81 mapped-page keyword misses previously verified on 2026-08-26 and 2026-08-28, plus the new `ShellWidgetHandoff` preview flag deferred above. No new gap. |
+| n/a (scoped slash-command re-verification, 2026-09-02) | 2026-09-02 | no | Already covered | Re-ran the surface-scoped slash check that works around the audit's repo-wide blind spot (the one that let `/usage` ship undocumented). All 44 GUI-visible commands in `app/src/search/slash_command_menu/static_commands/commands.rs` appear on `agents/capabilities/slash-commands.mdx` except `/docker-sandbox`, which is deliberately mapped `-> internal` (dogfood `LocalDockerSandbox`). No gap. |
+| HistorySearchRankingV2 (flag added, preview) | 2026-09-02 | deferred | Gate 0 | New preview-status feature flag (`PREVIEW_FLAGS` in `crates/warp_features/src/lib.rs`, bridge in `app/src/features.rs`). Not GA, so not documentable. Added to the surface-map ignore list with the other pre-launch toggles; snapshot diff re-flags on promotion or removal. Re-check on promotion to GA. |
+| n/a (23 potentially_stale_docs, 2026-09-02 re-run) | 2026-09-02 | no | Disqualified: not a docs gap / owned by style_lint | Same terminology-only hits as prior runs (including known `ai credits` bucket-name false positives). No missing content. |
+| GET /factory-inbox, POST /factory-inbox/notifications/{uid}/dismiss | 2026-09-01 | deferred | Gate 0 | Personal factory task inbox list and notification dismiss (`router/handlers/public_api/factory_inbox.go`, `RegisterFactoryInboxRoutes`). Not in released OpenAPI (`developers/agent-api-openapi.yaml` has zero `/factory-inbox` paths); same Factory REST exclusion as `/factory/*`. Mapped both routes `-> internal`. Re-check when the factory API is published. |
+| POST /factory/{uid}/learning | 2026-09-01 | deferred | Gate 0 | Starts a factory learning run (`StartFactoryLearningHandler` in `router/handlers/public_api/factories.go`). Inside the unreleased `/factory` namespace excluded by sync-openapi-spec; released OpenAPI has zero `/factory` paths. Mapped `-> internal`. Re-check when the factory API is published. |
+| n/a (23 potentially_stale_docs, 2026-09-01 re-run) | 2026-09-01 | no | Disqualified: not a docs gap / owned by style_lint | Same terminology-only hits as prior runs (including known `ai credits` bucket-name false positives). No missing content. |
+| GET /factory/{uid}/costs/breakdown, /costs/per-pr, /costs/per-pr/by-size, /costs/per-pr/top | 2026-08-31 | deferred | Gate 0 | Factory dashboard cost routes that replaced `metrics/cost-by-pr-size` and `metrics/top-prs` (`router/handlers/public_api/factories.go`). Still inside the unreleased `/factory` namespace; released OpenAPI has zero `/factory` paths. Mapped the four `/costs/*` routes `-> internal` and pruned the two dead `/metrics/*` map entries. Re-check when the factory API is published. |
+| NativeShellCompletions (flag dogfood→preview) | 2026-08-31 | deferred | Gate 0 | Flag promoted dogfood → preview (`PREVIEW_FLAGS` in `crates/warp_features/src/lib.rs`). UI toggles and runtime effect of `terminal.input.warp_completions_enabled` / `native_shell_completions_enabled` remain gated on `FeatureFlag::NativeShellCompletions`; when the flag is off, `resolve_completion_sources` forces Warp-only completions. Updated the all-settings rows to state that Preview gate (review feedback on docs#657). Still not GA — re-check on promotion to GA; leave the ignore-list entry. |
+| n/a (23 potentially_stale_docs, 2026-08-31 re-run) | 2026-08-31 | no | Disqualified: not a docs gap / owned by style_lint | Same terminology-only hits as the 2026-08-28 and 2026-08-26 rows (including the known `ai credits` bucket-name false positives). No missing content. |
+| LrcActivitySignal (flag added, dogfood) | 2026-08-30 | deferred | Gate 0 | New dogfood-status feature flag. Not GA, so not documentable. No map entry needed — dogfood flags sit in the `tracked_non_ga` accounting bucket and the snapshot diff re-flags the flag if it is promoted or removed. Re-check on promotion to preview or GA. |
+| /continue-locally, /handoff, /remote-control, /set-tab-color (GUI slash command table) | 2026-08-28 | yes | Gate 1 | Exhaustive re-run of the slash audit scoped by `SlashCommandSurfaces` (the standard check is repo-wide, the blind spot that let `/usage` ship undocumented). Four GA GuiOnly/GuiAndTui commands in `app/src/search/slash_command_menu/static_commands/commands.rs`, none carrying a `feature_flag`, were absent from the "built-in Slash Commands" table on `agents/capabilities/slash-commands.mdx`, which presents itself as the complete list. `/set-tab-color` was undocumented anywhere. Added four table rows plus a `/set-tab-color` paragraph under **Tab colors** in `terminal/windows/tabs.mdx` (feature PR). CLI side is clean: all 32 TUI-capable commands covered under `agents/cli/`. |
+| n/a (81 --weak-coverage feature findings) | 2026-08-28 | no | Disqualified: not a docs gap / heuristic false positive | Ran `--weak-coverage` for exhaustiveness. Every hit is a curated surface-map entry whose page lacks a phrase derived from the internal flag name. Spot-verified against code and docs: `FullScreenZenMode` → `workspace_decoration_visibility` documented in `all-settings.mdx`; `SuggestedRules` → `agents.warp_agent.active_ai.rule_suggestions_enabled` documented and behavior described in `rules.mdx`; `SharedWithMe` → direct and link sharing documented in `warp-drive/index.mdx`; `GroupedTabs`/`DragTabsToWindows`/`UndoClosedPanes` → all covered in `tabs.mdx`. |
+| n/a (KittyImages map target) | 2026-08-28 | n/a | Map hygiene | Surfaced by the same `--weak-coverage` pass. The entry pointed at `terminal/more-features/full-screen-apps.mdx`, which documents the Kitty *keyboard* protocol; the Kitty *image* protocol is documented on `terminal/more-features/files-and-links.mdx`. Retargeted the entry. No docs change needed. |
+| n/a (/docker-sandbox) | 2026-08-28 | no | Already mapped `-> internal` | Absent from the GUI slash command table, but deliberately mapped internal. Left out of the table completion above. |
+| n/a (23 potentially_stale_docs, itemized) | 2026-08-28 | no | Disqualified: not a docs gap / owned by style_lint | Re-verified line by line rather than in bulk. "AI credits" is the deliberate name of the inference bucket, contrasted throughout with compute credits and platform credits (`plans-and-billing/platform-credits.mdx`); "Warp AI" hits are verbatim telemetry event names in `privacy.mdx` plus one historical FAQ heading; "Warp Terminal" hits are the distinguishing usage the style guide permits; "generate command" and "AI command" refer to the live Generate and AI Command Search features. Supersedes the bulk row below. |
+| terminal.input.warp_completions_enabled, terminal.input.native_shell_completions_enabled | 2026-08-28 | yes | Gate 1 | Always-on bool knobs in `app/src/settings/input.rs` (`toml_path` each; defaults `true`). UI labels "Warp completions" and "Native shell completions" under **Settings** > **Features** > **Terminal Input** (`features_page.rs`), but both the Settings widgets and runtime effect are gated by Preview flag `NativeShellCompletions` — when the flag is off, `resolve_completion_sources` forces Warp-only. Documented in `terminal/settings/all-settings.mdx` under `[terminal.input]` with that availability gate (clarified 2026-08-31 after docs#657 review). |
+| agents.custom_endpoints | 2026-08-28 | yes | Gate 1 | Always-on structured setting `agents.custom_endpoints` in `app/src/settings/ai.rs` holding non-secret custom inference endpoint definitions (credentials stay in secure storage). Same pattern as `execution_profiles`. Feature already documented at `agents/inference/custom-inference-endpoint.mdx`; added the settings-file key to `terminal/settings/all-settings.mdx`. |
+| GET /factory/{uid}/integrations/issue-tracker/issues, POST /factory/{uid}/integrations/slack/connection-test-greeting | 2026-08-28 | deferred | Gate 0 | New public_api factory routes in `router/handlers/public_api/factories.go`. Released OpenAPI has zero `/factory` paths; sync-openapi-spec excludes the namespace while the Factory REST API is unreleased. Mapped `-> internal`; re-check when the factory API is published. |
+| agents.warp_agent.other.usage_display_unit | 2026-08-28 | deferred | Gate 0 | New GUI setting gated by dogfood flag `PricingTransparency` (`app/src/settings/ai.rs`). Snapshot status dogfood; not documentable until the flag is GA. Tracked by snapshot; re-check on promotion. |
+| NativeShellCompletions (flag other→dogfood) | 2026-08-28 | deferred | Gate 0 | Flag status moved other → dogfood. Already on the ignore list as a sub-feature toggle; the always-on settings above are the documentable knobs. Re-check only if the flag is promoted and changes user-facing surface beyond those settings. |
+| n/a (changelog 2026.08.27 Factories EA) | 2026-08-28 | no | Disqualifier: major launch / already documented | Duplicate of the 2026.08.25 Factories EA launch bullet already decided. Full `src/content/docs/factories/` set already ships. |
+| [#15515](https://github.com/warpdotdev/warp/pull/15515) | 2026-08-28 | no | Disqualified: pure UI affordance | Removed first-time-user banners/prompts on shared session or conversation transcript views. No setting or workflow change for the reader. |
+| [#15258](https://github.com/warpdotdev/warp/pull/15258) | 2026-08-28 | no | Disqualified: small and intuitive | Disabled team/workspace members shown grayed out with a tooltip. Understood on sight; no configuration. |
+| [#15424](https://github.com/warpdotdev/warp/pull/15424) | 2026-08-28 | no | Disqualified: pure UI affordance | Renamed settings page "Oz Cloud API Keys" → "API keys" under Cloud platform. Docs already say "API keys" (`reference/cli/api-keys.mdx`); no remaining "Oz Cloud API Keys" prose outside the changelog. |
+| [#15395](https://github.com/warpdotdev/warp/pull/15395) | 2026-08-28 | no | Disqualified: no user-observable change requiring action / platform parity | IME composition input enabled on Windows and Linux (was macOS-only). Restores expected input behavior; no knob or setup steps. |
+| [#15365](https://github.com/warpdotdev/warp/pull/15365) | 2026-08-28 | no | Already documented (Gate 1 covered) | Right-click paste setting. Concrete knob `terminal.input.right_click_behavior` already documented in `all-settings.mdx` with options `context_menu` / `paste` and Shift+right-click note. No further docs change. |
+| [#15340](https://github.com/warpdotdev/warp/pull/15340) | 2026-08-28 | no | Already documented (Gate 1 covered) | Setting to stop `#` opening AI Command Search. Concrete knob `terminal.input.enable_ai_command_search_hash_trigger` already in `all-settings.mdx` with default and keyboard-shortcut fallback. No further docs change. |
+| [#15148](https://github.com/warpdotdev/warp/pull/15148) | 2026-08-28 | no | Gate 0 / disqualified: pure UI affordance for GA surface | Usage surfaces show per-category dollar cost alongside credits. The configurable unit `agents.warp_agent.other.usage_display_unit` is dogfood-gated by `PricingTransparency`; the visible dual display is an improvement to existing usage UI, small and intuitive once shown. Defer documenting the unit setting until GA. |
+| [#15346](https://github.com/warpdotdev/warp/pull/15346) | 2026-08-28 | no | Disqualified: pure UI affordance | Added "Paste" to the terminal block list right-click context menu. No setting. |
+| [#13967](https://github.com/warpdotdev/warp/pull/13967) | 2026-08-28 | no | Disqualified: no user-observable change requiring action | Markdown viewer preserves scroll position between Rendered and Raw modes. Improves on its own. |
+| [#15221](https://github.com/warpdotdev/warp/pull/15221) | 2026-08-28 | no | Disqualified: pure UI affordance / small and intuitive | Holding a modifier shows each tab's switch-to-tab shortcut on the tab. Discoverable in-product; shortcuts already documented. |
+| [#15505](https://github.com/warpdotdev/warp/pull/15505) | 2026-08-28 | no | Disqualified: bug fix restoring intended behavior | Fixed handoff snapshot files not reaching a rebuilt cloud sandbox. Restores expected handoff file availability; handoff docs already describe the feature. |
+| n/a (changelog 2026.08.25 Factories EA) | 2026-08-28 | no | Disqualifier: major launch / already documented | Already decided 2026-08-25; repeated here only because the snapshot's last-seen changelog version lagged this release range. |
+| [#14968](https://github.com/warpdotdev/warp/pull/14968) | 2026-08-28 | no | Already decided 2026-08-25 | Inline `/usage` already verdicted yes; prior run owns the docs update. Skipped re-draft. |
+| n/a (oz_updates / changelog 2026.08.25 MCP) | 2026-08-28 | no | Already decided 2026-08-25 | Intermittent MCP-after-rebuild fix already verdicted no as a bug fix. |
+| n/a (23 potentially_stale_docs findings) | 2026-08-28 | no | Disqualified: not a docs gap / owned by style_lint | Same class as 2026-08-26: terminology matches only (including known `ai credits` false positives). No missing content. |
 | POST /agent/runs/{runId}/environment-snapshot | 2026-08-26 | no | Gate 0 + disqualified: no user-observable surface | Marked `x-internal: true` in warp-server's canonical spec, so the publish filter strips it from `developers/agent-api-openapi.yaml`. Registered behind `ambient_task.ValidateAmbientTask` + `RequireCloudAgent(true)` and rejects any caller whose token is not the run's own active execution (`agent_environment_snapshot.go`), so no API consumer can ever call it. Machine-facing worker plumbing like its `client-events` and `event-sequence` siblings. Mapped `-> internal`. |
 | POST /factory/{uid}/github-onboarding-pr | 2026-08-26 | deferred | Gate 0 | Opens/refreshes the throwaway branch and PR that verify a factory's GitHub connection during onboarding (`factories.go`). In the `/factory` namespace, which sync-openapi-spec excludes wholesale while the Factory REST API is unreleased; released public spec has zero `/factory` paths. Mapped `-> internal`; re-check when the factory API is published. |
 | POST /factory/{uid}/source/branch/sync, DELETE /factory/{uid}/source/branch | 2026-08-26 | deferred | Gate 0 | Integrate production drift into, and discard, a `warp/code/*` working branch behind the factory definition editor (`factory_code_browser.go`). Same `/factory` namespace exclusion as the sibling `source/*` routes already mapped internal. Mapped `-> internal`; re-check with the factory API publish. |