From 52df8798b3edbf1c639903b68e29562bbc90c58b Mon Sep 17 00:00:00 2001 From: "warp-factories[bot]" <243557089+warp-factories[bot]@users.noreply.github.com> Date: Fri, 28 Aug 2026 16:09:51 +0000 Subject: [PATCH 1/7] docs: document completion and custom endpoint settings keys Add warp_completions_enabled, native_shell_completions_enabled, and agents.custom_endpoints to the all-settings reference for the v0.2026.08.26.17.59.stable_01 missing_docs drift-watch triage. Fold in surface-map internal factory routes, changelog verdicts, release marker, and snapshot regen. Co-Authored-By: Oz --- .../references/changelog_decisions.md | 21 +++++++++++++++++++ .../references/feature_surface_map.md | 4 ++++ .../references/last_release_processed.json | 8 +++---- .../references/surface_snapshot.json | 10 +++++++-- .../docs/terminal/settings/all-settings.mdx | 3 +++ 5 files changed, 40 insertions(+), 6 deletions(-) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index 5d220098..4ea16bfc 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,6 +32,27 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome | |---|---|---|---|---| +| 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`). Documented in `terminal/settings/all-settings.mdx` under `[terminal.input]`. | +| 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. | diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index 04b46853..706fad39 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -528,6 +528,10 @@ GET /factory/{uid}/integrations/linear/users -> internal GET /factory/{uid}/integrations/linear/workflow-states -> internal GET /factory/{uid}/integrations/slack/conversations -> internal GET /factory/{uid}/integrations/slack/users -> internal +# Issue-tracker issue picker and Slack connection-test greeting used by the +# factory integrations UI. Same unreleased `/factory` namespace as siblings above. +GET /factory/{uid}/integrations/issue-tracker/issues -> internal +POST /factory/{uid}/integrations/slack/connection-test-greeting -> internal # Factory benchmark suites and benchmark runs # (router/handlers/public_api/benchmarks.go). Same unreleased Factory product as # the routes above, and absent from warp-server's canonical public spec. diff --git a/.agents/skills/missing_docs/references/last_release_processed.json b/.agents/skills/missing_docs/references/last_release_processed.json index 141290a6..a8927647 100644 --- a/.agents/skills/missing_docs/references/last_release_processed.json +++ b/.agents/skills/missing_docs/references/last_release_processed.json @@ -1,8 +1,8 @@ { - "last_processed_version": "v0.2026.08.19.08.15.stable_01", - "release_date": "2026-08-19T22:28:46Z", - "processed_at": "2026-08-25T00:58:59Z", - "changelog_entry_count": 5, + "last_processed_version": "v0.2026.08.26.17.59.stable_01", + "release_date": "2026-08-27T23:50:37+0000", + "processed_at": "2026-08-28T16:06:31Z", + "changelog_entry_count": 39, "oz_updates_count": 1, "_comment": "Written by check_new_release.py --commit after a drift-watch run completes triage. Kept separate from surface_snapshot.json, which is regenerated wholesale and would lose this marker. Do not hand-edit; to force a re-run of the current release, delete this file." } diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index eae73b29..c95c3017 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -188,7 +188,7 @@ "MultiProfile": "ga", "MultiWorkspace": "dogfood", "NamedAgents": "ga", - "NativeShellCompletions": "other", + "NativeShellCompletions": "dogfood", "NewTabStyling": "ga", "NldPromptHistoryMatch": "other", "OpenCodeNotifications": "ga", @@ -896,6 +896,7 @@ "GET /api/v1/factory/{uid}/integrations/github/teams", "GET /api/v1/factory/{uid}/integrations/github/users", "GET /api/v1/factory/{uid}/integrations/github/workflows", + "GET /api/v1/factory/{uid}/integrations/issue-tracker/issues", "GET /api/v1/factory/{uid}/integrations/jira/labels", "GET /api/v1/factory/{uid}/integrations/jira/projects", "GET /api/v1/factory/{uid}/integrations/jira/statuses", @@ -976,6 +977,7 @@ "POST /api/v1/factory/{uid}/benchmarks/tasks/compose-from-run", "POST /api/v1/factory/{uid}/github-onboarding-pr", "POST /api/v1/factory/{uid}/gitlab-automation-capability/refresh", + "POST /api/v1/factory/{uid}/integrations/slack/connection-test-greeting", "POST /api/v1/factory/{uid}/merges", "POST /api/v1/factory/{uid}/merges/check", "POST /api/v1/factory/{uid}/plan", @@ -1087,6 +1089,7 @@ "accessibility.accessibility_verbosity": "always_on", "account.is_settings_sync_enabled": "always_on", "agents.cloud_conversation_storage_enabled": "always_on", + "agents.custom_endpoints": "always_on", "agents.execution_profiles": "always_on", "agents.knowledge.rules_enabled": "always_on", "agents.knowledge.warp_drive_context_enabled": "always_on", @@ -1140,6 +1143,7 @@ "agents.warp_agent.other.show_agent_notifications": "always_on", "agents.warp_agent.other.show_conversation_history": "always_on", "agents.warp_agent.other.thinking_display_mode": "always_on", + "agents.warp_agent.other.usage_display_unit": "dogfood", "appearance.blocks.should_show_bootstrap_block": "always_on", "appearance.blocks.should_show_in_band_command_blocks": "always_on", "appearance.blocks.should_show_ssh_block": "always_on", @@ -1281,11 +1285,13 @@ "terminal.input.honor_ps1": "always_on", "terminal.input.input_box_type_setting": "always_on", "terminal.input.middle_click_paste_enabled": "always_on", + "terminal.input.native_shell_completions_enabled": "always_on", "terminal.input.outline_codebase_symbols_for_at_context_menu": "always_on", "terminal.input.right_click_behavior": "always_on", "terminal.input.show_hint_text": "always_on", "terminal.input.show_terminal_input_message_bar": "always_on", "terminal.input.syntax_highlighting": "always_on", + "terminal.input.warp_completions_enabled": "always_on", "terminal.maximum_grid_size": "always_on", "terminal.mouse_reporting_enabled": "always_on", "terminal.osc52_clipboard_access": "always_on", @@ -1430,5 +1436,5 @@ "verify-ui-change-in-cloud": "dogfood", "warpctrl": "bundled" }, - "changelog_last_version": "2026.08.19" + "changelog_last_version": "2026.08.27" } diff --git a/src/content/docs/terminal/settings/all-settings.mdx b/src/content/docs/terminal/settings/all-settings.mdx index e5a37b01..761c6fea 100644 --- a/src/content/docs/terminal/settings/all-settings.mdx +++ b/src/content/docs/terminal/settings/all-settings.mdx @@ -187,6 +187,8 @@ Settings that control terminal behavior, input, and event handling. * `error_underlining_enabled` — Whether command errors are underlined in the input. Type: boolean. Default: `true`. * `completions_open_while_typing` — Whether the completions menu opens automatically while typing. Type: boolean. Default: `false`. * `classic_completions_mode` — Whether classic completions mode is enabled. Type: boolean. Default: `false`. +* `warp_completions_enabled` — Whether Warp's built-in completions are shown for shell commands. When enabled, **Settings** > **Features** > **Terminal Input** also exposes "Open completions menu as you type" as a nested control (the same knob as `completions_open_while_typing`). Type: boolean. Default: `true`. +* `native_shell_completions_enabled` — Whether your shell's own completions are used for shell commands. Native shell completions are not generated as you type; press `Tab` (or your completions keybinding) to fetch them. Type: boolean. Default: `true`. * `show_hint_text` — Whether hint text is shown in the terminal input. Type: boolean. Default: `true`. * `show_terminal_input_message_bar` — Whether the terminal input message bar is shown. Type: boolean. Default: `true`. * `enable_slash_commands_in_terminal` — Whether slash commands are available in the terminal input. Type: boolean. Default: `true`. @@ -265,6 +267,7 @@ Settings for Warp's agents, including model behavior, permissions, knowledge, MC * `cloud_conversation_storage_enabled` — Whether conversations are stored in the cloud. Type: boolean. Default: `true`. * `usage_display_mode` — Which unit the terminal agent's usage entry displays. Applies only to the terminal agent's settings file; click the usage entry to flip between units. Type: string. Default: `"credits"`. Options: `"credits"` (the same number the desktop app's usage footer shows), `"cost"` (provider dollar cost). * `execution_profiles` — The collection of [agent profiles](/agents/capabilities/agent-profiles-permissions/) and their permissions, shared by Agent Mode and the terminal agent. This is a structured object that Warp manages when you create and edit profiles in **Settings** > **Agents** > **Profiles**; edit it through the UI rather than by hand. Type: object. Default: `{}` (Warp's built-in profiles). +* `custom_endpoints` — Non-secret [custom inference endpoint](/agents/inference/custom-inference-endpoint/) definitions (URL, models, schema). Credentials stay in local secure storage, not in this object. Warp manages the collection from **Settings**; edit it through the UI rather than by hand. Type: object. Default: `{}`. ### Knowledge From bcbb5feeef9764bcd7372be5c1f6fe15bae2eff2 Mon Sep 17 00:00:00 2001 From: Oz Date: Fri, 28 Aug 2026 17:16:44 +0000 Subject: [PATCH 2/7] chore(missing_docs): record exhaustive-pass verdicts and fix KittyImages map target Second, exhaustive pass over the same release. Adds ledger rows for the surface-scoped slash command finding (shipped as its own feature PR), the 81 --weak-coverage findings, and an itemized re-verification of the 23 potentially_stale_docs findings that supersedes the earlier bulk row. Retargets the KittyImages map entry: it pointed at full-screen-apps.mdx, which documents the Kitty keyboard protocol, but the Kitty image protocol is documented on files-and-links.mdx. Co-Authored-By: Warp --- .../skills/missing_docs/references/changelog_decisions.md | 5 +++++ .../skills/missing_docs/references/feature_surface_map.md | 4 +++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index 4ea16bfc..f433e5b3 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,6 +32,11 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome | |---|---|---|---|---| +| /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`). Documented in `terminal/settings/all-settings.mdx` under `[terminal.input]`. | | 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. | diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index 706fad39..a3e8b7e6 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -141,7 +141,9 @@ Changelog -> src/content/docs/changelog/index.mdx Autoupdate -> src/content/docs/support-and-community/troubleshooting-and-support/updating-warp.mdx ShellSelector -> src/content/docs/getting-started/supported-shells.mdx WorkflowAliases -> src/content/docs/terminal/entry/yaml-workflows.mdx -KittyImages -> src/content/docs/terminal/more-features/full-screen-apps.mdx +# The Kitty *image* protocol is documented on files-and-links.mdx; full-screen-apps.mdx +# covers the Kitty *keyboard* protocol, which is a different surface. +KittyImages -> src/content/docs/terminal/more-features/files-and-links.mdx UndoClosedPanes -> src/content/docs/terminal/windows/tabs.mdx # Tab groups (organize tabs into named, collapsible groups) — GA (in the default # feature set). From e336dbc449807ff24d9f5611ecd06f9572bf955d Mon Sep 17 00:00:00 2001 From: "warp-factories[bot]" <243557089+warp-factories[bot]@users.noreply.github.com> Date: Sun, 30 Aug 2026 16:04:44 +0000 Subject: [PATCH 3/7] chore(missing_docs): record LrcActivitySignal deferral and refresh snapshot Drift-watch re-run after v0.2026.08.26.17.59.stable_01 bookkeeping: defer the new dogfood flag and regenerate the surface snapshot so the next --diff run is clean of medium findings. --- .agents/skills/missing_docs/references/changelog_decisions.md | 1 + .agents/skills/missing_docs/references/surface_snapshot.json | 1 + 2 files changed, 2 insertions(+) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index f433e5b3..484ca393 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,6 +32,7 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome | |---|---|---|---|---| +| 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. | diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index c95c3017..293e799b 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -173,6 +173,7 @@ "LocalComputerUse": "dogfood", "LocalDockerSandbox": "dogfood", "LogExpensiveFramesInSentry": "dogfood", + "LrcActivitySignal": "dogfood", "MCPGroupedServerContext": "ga", "MSYS2Shells": "dogfood", "MarkdownImages": "dogfood", From a5c18ad377117e30365d0dd3765329152023685a Mon Sep 17 00:00:00 2001 From: "warp-factories[bot]" <243557089+warp-factories[bot]@users.noreply.github.com> Date: Mon, 31 Aug 2026 16:09:51 +0000 Subject: [PATCH 4/7] chore(missing_docs): gate completion settings and map factory cost routes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Address docs#657 review: state that warp/native completion toggles only take effect under the Native shell completions Preview. Map the four factory /costs/* API routes as internal, prune dead /metrics/* map entries, record the dogfood→preview NativeShellCompletions deferral, and refresh the surface snapshot. --- .../skills/missing_docs/references/changelog_decisions.md | 5 ++++- .../skills/missing_docs/references/feature_surface_map.md | 8 ++++++-- .../missing_docs/references/last_release_processed.json | 2 +- .../skills/missing_docs/references/surface_snapshot.json | 8 +++++--- src/content/docs/terminal/settings/all-settings.mdx | 4 ++-- 5 files changed, 18 insertions(+), 9 deletions(-) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index 484ca393..71080229 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,13 +32,16 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome | |---|---|---|---|---| +| 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`). Documented in `terminal/settings/all-settings.mdx` under `[terminal.input]`. | +| 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. | diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index a3e8b7e6..4182d96f 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -478,9 +478,13 @@ POST /factory/{uid}/runs -> internal # Also marked `x-internal: true` in warp-server's canonical spec, so the publish # filter strips it from the public docs copy. GET /factory/{uid}/metrics -> internal -GET /factory/{uid}/metrics/cost-by-pr-size -> internal GET /factory/{uid}/metrics/run-breakdown -> internal -GET /factory/{uid}/metrics/top-prs -> internal +# Cost breakdown and per-PR cost views moved under /costs/* (former +# metrics/cost-by-pr-size and metrics/top-prs paths removed in warp-server). +GET /factory/{uid}/costs/breakdown -> internal +GET /factory/{uid}/costs/per-pr -> internal +GET /factory/{uid}/costs/per-pr/by-size -> internal +GET /factory/{uid}/costs/per-pr/top -> internal GET /factory/{uid}/integrations/linear/teams -> internal GET /factory/{uid}/integrations/linear/teams/{team_id}/labels -> internal PUT /factory/{uid}/integrations/linear/teams/{team_id}/labels -> internal diff --git a/.agents/skills/missing_docs/references/last_release_processed.json b/.agents/skills/missing_docs/references/last_release_processed.json index a8927647..ac04262c 100644 --- a/.agents/skills/missing_docs/references/last_release_processed.json +++ b/.agents/skills/missing_docs/references/last_release_processed.json @@ -1,7 +1,7 @@ { "last_processed_version": "v0.2026.08.26.17.59.stable_01", "release_date": "2026-08-27T23:50:37+0000", - "processed_at": "2026-08-28T16:06:31Z", + "processed_at": "2026-08-31T16:06:48Z", "changelog_entry_count": 39, "oz_updates_count": 1, "_comment": "Written by check_new_release.py --commit after a drift-watch run completes triage. Kept separate from surface_snapshot.json, which is regenerated wholesale and would lose this marker. Do not hand-edit; to force a re-run of the current release, delete this file." diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index 293e799b..8db37a87 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -189,7 +189,7 @@ "MultiProfile": "ga", "MultiWorkspace": "dogfood", "NamedAgents": "ga", - "NativeShellCompletions": "dogfood", + "NativeShellCompletions": "preview", "NewTabStyling": "ga", "NldPromptHistoryMatch": "other", "OpenCodeNotifications": "ga", @@ -889,6 +889,10 @@ "GET /api/v1/factory/{uid}/benchmarks/runs/{run_uid}/results", "GET /api/v1/factory/{uid}/benchmarks/suites", "GET /api/v1/factory/{uid}/benchmarks/suites/{suite_uid}", + "GET /api/v1/factory/{uid}/costs/breakdown", + "GET /api/v1/factory/{uid}/costs/per-pr", + "GET /api/v1/factory/{uid}/costs/per-pr/by-size", + "GET /api/v1/factory/{uid}/costs/per-pr/top", "GET /api/v1/factory/{uid}/gitlab-automation-capability", "GET /api/v1/factory/{uid}/integration-activations", "GET /api/v1/factory/{uid}/integration-destinations", @@ -911,9 +915,7 @@ "GET /api/v1/factory/{uid}/integrations/slack/users", "GET /api/v1/factory/{uid}/merges/{merge_uid}", "GET /api/v1/factory/{uid}/metrics", - "GET /api/v1/factory/{uid}/metrics/cost-by-pr-size", "GET /api/v1/factory/{uid}/metrics/run-breakdown", - "GET /api/v1/factory/{uid}/metrics/top-prs", "GET /api/v1/factory/{uid}/review", "GET /api/v1/factory/{uid}/source", "GET /api/v1/factory/{uid}/source/export", diff --git a/src/content/docs/terminal/settings/all-settings.mdx b/src/content/docs/terminal/settings/all-settings.mdx index 761c6fea..b846c6fc 100644 --- a/src/content/docs/terminal/settings/all-settings.mdx +++ b/src/content/docs/terminal/settings/all-settings.mdx @@ -187,8 +187,8 @@ Settings that control terminal behavior, input, and event handling. * `error_underlining_enabled` — Whether command errors are underlined in the input. Type: boolean. Default: `true`. * `completions_open_while_typing` — Whether the completions menu opens automatically while typing. Type: boolean. Default: `false`. * `classic_completions_mode` — Whether classic completions mode is enabled. Type: boolean. Default: `false`. -* `warp_completions_enabled` — Whether Warp's built-in completions are shown for shell commands. When enabled, **Settings** > **Features** > **Terminal Input** also exposes "Open completions menu as you type" as a nested control (the same knob as `completions_open_while_typing`). Type: boolean. Default: `true`. -* `native_shell_completions_enabled` — Whether your shell's own completions are used for shell commands. Native shell completions are not generated as you type; press `Tab` (or your completions keybinding) to fetch them. Type: boolean. Default: `true`. +* `warp_completions_enabled` — Whether Warp's built-in completions are shown for shell commands. Effective only while the Native shell completions Preview is enabled for your account; otherwise Warp always uses built-in completions. When this setting is in effect and enabled, **Settings** > **Features** > **Terminal Input** also exposes "Open completions menu as you type" as a nested control (the same knob as `completions_open_while_typing`). Type: boolean. Default: `true`. +* `native_shell_completions_enabled` — Whether your shell's own completions are used for shell commands. Effective only while the Native shell completions Preview is enabled for your account; otherwise the setting is ignored and native completions stay off. Native shell completions are not generated as you type; press `Tab` (or your completions keybinding) to fetch them. Type: boolean. Default: `true`. * `show_hint_text` — Whether hint text is shown in the terminal input. Type: boolean. Default: `true`. * `show_terminal_input_message_bar` — Whether the terminal input message bar is shown. Type: boolean. Default: `true`. * `enable_slash_commands_in_terminal` — Whether slash commands are available in the terminal input. Type: boolean. Default: `true`. From e802df62d1fe58c50a5b2a5df38860fcbd14162c Mon Sep 17 00:00:00 2001 From: "warp-factories[bot]" <243557089+warp-factories[bot]@users.noreply.github.com> Date: Tue, 1 Sep 2026 16:10:45 +0000 Subject: [PATCH 5/7] chore(missing_docs): map factory-inbox and learning routes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Extend docs#657 bookkeeping for the v0.2026.08.26 release re-run: map GET/POST /factory-inbox* and POST /factory/{uid}/learning as internal (Gate 0 — unreleased Factory REST), record ledger verdicts, refresh last_release marker timestamp and surface snapshot. --- .../skills/missing_docs/references/changelog_decisions.md | 3 +++ .../skills/missing_docs/references/feature_surface_map.md | 8 ++++++++ .../missing_docs/references/last_release_processed.json | 2 +- .../skills/missing_docs/references/surface_snapshot.json | 3 +++ 4 files changed, 15 insertions(+), 1 deletion(-) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index 71080229..987ce3c0 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,6 +32,9 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome | |---|---|---|---|---| +| 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. | diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index 4182d96f..c35e0eef 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -411,6 +411,11 @@ POST /harness-support/commit-snapshot -> internal # `x-internal` markers come off. See SKILL.md "Public vs. private surfaces". GET /factory -> internal GET /factory/access -> internal +# Personal factory task inbox (router/handlers/public_api/factory_inbox.go). +# Sibling of the unreleased `/factory` REST surface; released OpenAPI has no +# `/factory-inbox` paths either. Stays internal until the Factory API ships. +GET /factory-inbox -> internal +POST /factory-inbox/notifications/{uid}/dismiss -> internal GET /factory-alias/{alias} -> internal POST /factory -> internal POST /factory/avatar -> internal @@ -475,6 +480,9 @@ GET /factory/{uid}/task-by-run -> internal # the `/factory` prefix) while the Factory REST API is unreleased. Revisit # together with that exclusion when the Factory API ships publicly. POST /factory/{uid}/runs -> internal +# Starts a factory learning run from production feedback +# (StartFactoryLearningHandler). Same unreleased `/factory` namespace exclusion. +POST /factory/{uid}/learning -> internal # Also marked `x-internal: true` in warp-server's canonical spec, so the publish # filter strips it from the public docs copy. GET /factory/{uid}/metrics -> internal diff --git a/.agents/skills/missing_docs/references/last_release_processed.json b/.agents/skills/missing_docs/references/last_release_processed.json index ac04262c..3d5f344c 100644 --- a/.agents/skills/missing_docs/references/last_release_processed.json +++ b/.agents/skills/missing_docs/references/last_release_processed.json @@ -1,7 +1,7 @@ { "last_processed_version": "v0.2026.08.26.17.59.stable_01", "release_date": "2026-08-27T23:50:37+0000", - "processed_at": "2026-08-31T16:06:48Z", + "processed_at": "2026-09-01T16:09:44Z", "changelog_entry_count": 39, "oz_updates_count": 1, "_comment": "Written by check_new_release.py --commit after a drift-watch run completes triage. Kept separate from surface_snapshot.json, which is regenerated wholesale and would lose this marker. Do not hand-edit; to force a re-run of the current release, delete this file." diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index 8db37a87..578bc78a 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -867,6 +867,7 @@ "GET /api/v1/factory-files/schemas", "GET /api/v1/factory-files/schemas/{schema_version}", "GET /api/v1/factory-files/schemas/{schema_version}/{document}", + "GET /api/v1/factory-inbox", "GET /api/v1/factory-setup/integrations/jira/projects", "GET /api/v1/factory-setup/integrations/linear/teams", "GET /api/v1/factory/access", @@ -964,6 +965,7 @@ "POST /api/v1/agent/tasks/{id}/cancel", "POST /api/v1/factory", "POST /api/v1/factory-files/validate", + "POST /api/v1/factory-inbox/notifications/{uid}/dismiss", "POST /api/v1/factory/automations", "POST /api/v1/factory/automations/{id}/run", "POST /api/v1/factory/avatar", @@ -981,6 +983,7 @@ "POST /api/v1/factory/{uid}/github-onboarding-pr", "POST /api/v1/factory/{uid}/gitlab-automation-capability/refresh", "POST /api/v1/factory/{uid}/integrations/slack/connection-test-greeting", + "POST /api/v1/factory/{uid}/learning", "POST /api/v1/factory/{uid}/merges", "POST /api/v1/factory/{uid}/merges/check", "POST /api/v1/factory/{uid}/plan", From 65f064c6e2032e7b4d4439d532e2231533c218fd Mon Sep 17 00:00:00 2001 From: "warp-factories[bot]" <243557089+warp-factories[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 16:08:17 +0000 Subject: [PATCH 6/7] chore(missing_docs): defer HistorySearchRankingV2 preview flag Record Gate 0 deferral for the new preview history-search ranking flag, add it to the surface-map ignore list, and refresh the surface snapshot. --- .agents/skills/missing_docs/references/changelog_decisions.md | 2 ++ .agents/skills/missing_docs/references/feature_surface_map.md | 3 +++ .../skills/missing_docs/references/last_release_processed.json | 2 +- .agents/skills/missing_docs/references/surface_snapshot.json | 1 + 4 files changed, 7 insertions(+), 1 deletion(-) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index 987ce3c0..255d1c73 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,6 +32,8 @@ Newest first. One row per PR number — usually a `warpdotdev/warp` changelog it | PR | Decided | Verdict | Gate / disqualifier | Reason and outcome | |---|---|---|---|---| +| 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. | diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index c35e0eef..28253682 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -870,6 +870,9 @@ CodeModeChip # Internal agent file-search tool plumbing (read tools are not individually documented). GrepTool NativeShellCompletions +# Preview ranking experiment for command history search. No dedicated user-facing +# knob beyond the existing history search UI; re-check when the flag goes GA. +HistorySearchRankingV2 SshDragAndDrop ITermImages AIGeneratedOnboardingSuggestions diff --git a/.agents/skills/missing_docs/references/last_release_processed.json b/.agents/skills/missing_docs/references/last_release_processed.json index 3d5f344c..179d1a93 100644 --- a/.agents/skills/missing_docs/references/last_release_processed.json +++ b/.agents/skills/missing_docs/references/last_release_processed.json @@ -1,7 +1,7 @@ { "last_processed_version": "v0.2026.08.26.17.59.stable_01", "release_date": "2026-08-27T23:50:37+0000", - "processed_at": "2026-09-01T16:09:44Z", + "processed_at": "2026-09-02T16:07:55Z", "changelog_entry_count": 39, "oz_updates_count": 1, "_comment": "Written by check_new_release.py --commit after a drift-watch run completes triage. Kept separate from surface_snapshot.json, which is regenerated wholesale and would lose this marker. Do not hand-edit; to force a re-run of the current release, delete this file." diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index 578bc78a..a2a9f163 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -146,6 +146,7 @@ "HandoffCloudCloud": "ga", "HandoffLocalCloud": "ga", "HarnessSessionHeader": "other", + "HistorySearchRankingV2": "preview", "HoaCodeReview": "ga", "ITermImages": "other", "ImageAsContext": "ga", From bd7201c97ced6aa3d6a43751e52ed1087ae266fb Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Wed, 2 Sep 2026 17:11:23 +0000 Subject: [PATCH 7/7] chore(missing_docs): defer ShellWidgetHandoff and map factory Linear handoff route Exhaustive drift-watch re-run for v0.2026.08.26.17.59.stable_01. - Ignore the new ShellWidgetHandoff preview flag (Gate 0: not GA). - Map POST /factory/{uid}/integrations/linear/handoff -> internal (Gate 0: unreleased /factory namespace). - Record this run's verdicts, including the corrected staleness verdict for the three live "Warp AI credits" usages. - Refresh surface_snapshot.json. Co-Authored-By: Warp --- .../skills/missing_docs/references/changelog_decisions.md | 5 +++++ .../skills/missing_docs/references/feature_surface_map.md | 8 ++++++++ .../skills/missing_docs/references/surface_snapshot.json | 2 ++ 3 files changed, 15 insertions(+) diff --git a/.agents/skills/missing_docs/references/changelog_decisions.md b/.agents/skills/missing_docs/references/changelog_decisions.md index 255d1c73..7cd0d195 100644 --- a/.agents/skills/missing_docs/references/changelog_decisions.md +++ b/.agents/skills/missing_docs/references/changelog_decisions.md @@ -32,6 +32,11 @@ 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. | diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index 28253682..0e8e7688 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -546,6 +546,10 @@ GET /factory/{uid}/integrations/slack/users -> internal # factory integrations UI. Same unreleased `/factory` namespace as siblings above. GET /factory/{uid}/integrations/issue-tracker/issues -> internal POST /factory/{uid}/integrations/slack/connection-test-greeting -> internal +# Hands a Linear issue to the factory from the integrations test-connections +# flow (CreateFactoryLinearTaskHandoffHandler). Same unreleased `/factory` +# namespace exclusion as the integration routes above. +POST /factory/{uid}/integrations/linear/handoff -> internal # Factory benchmark suites and benchmark runs # (router/handlers/public_api/benchmarks.go). Same unreleased Factory product as # the routes above, and absent from warp-server's canonical public spec. @@ -873,6 +877,10 @@ NativeShellCompletions # Preview ranking experiment for command history search. No dedicated user-facing # knob beyond the existing history search UI; re-check when the flag goes GA. HistorySearchRankingV2 +# Preview flag that 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; +# re-check when the flag goes GA. +ShellWidgetHandoff SshDragAndDrop ITermImages AIGeneratedOnboardingSuggestions diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json index a2a9f163..829441c4 100644 --- a/.agents/skills/missing_docs/references/surface_snapshot.json +++ b/.agents/skills/missing_docs/references/surface_snapshot.json @@ -249,6 +249,7 @@ "SharedSessionWriteToLongRunningCommands": "ga", "SharedWithMe": "ga", "ShellSelector": "ga", + "ShellWidgetHandoff": "preview", "SimulateGithubUnauthed": "other", "SkillArguments": "ga", "SkipFirebaseAnonymousUser": "ga", @@ -983,6 +984,7 @@ "POST /api/v1/factory/{uid}/benchmarks/tasks/compose-from-run", "POST /api/v1/factory/{uid}/github-onboarding-pr", "POST /api/v1/factory/{uid}/gitlab-automation-capability/refresh", + "POST /api/v1/factory/{uid}/integrations/linear/handoff", "POST /api/v1/factory/{uid}/integrations/slack/connection-test-greeting", "POST /api/v1/factory/{uid}/learning", "POST /api/v1/factory/{uid}/merges",