Skip to content

Add FAQ documentation for contributors and users#9591

Closed
warp-repo-sync[bot] wants to merge 1 commit intomasterfrom
repo-sync/private-to-public/11edee2
Closed

Add FAQ documentation for contributors and users#9591
warp-repo-sync[bot] wants to merge 1 commit intomasterfrom
repo-sync/private-to-public/11edee2

Conversation

@warp-repo-sync
Copy link
Copy Markdown

@warp-repo-sync warp-repo-sync Bot commented Apr 30, 2026

Adds a comprehensive FAQ document covering contributing to the Warp client, working with agents in the repository, licensing, and the relationship between open-source and proprietary components. The FAQ clarifies contribution workflows, issue readiness labels, spec PR requirements, agent usage, collaboration roles, licensing choices (AGPL for the client, MIT for UI frameworks), and security reporting procedures.

Repo-Sync-Origin: warpdotdev/warp-internal@11edee28433c4087a3422c8db20c408c897e6df3

Repo-Sync-Conflict: cherry-pick

Repo-Sync-Assigned: app/warp-repo-sync-approval@2026-04-30T13:35:27Z

@warp-repo-sync warp-repo-sync Bot added the repo-sync:conflict Sync PR has merge conflicts label Apr 30, 2026
@cla-bot cla-bot Bot added the cla-signed label Apr 30, 2026
@warp-repo-sync
Copy link
Copy Markdown
Author

Assigning to @app/warp-repo-sync-approval to review/resolve sync conflict.

@oz-for-oss
Copy link
Copy Markdown
Contributor

oz-for-oss Bot commented Apr 30, 2026

@warp-repo-sync[bot]

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and posted feedback on this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Copy link
Copy Markdown
Contributor

@oz-for-oss oz-for-oss Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR adds FAQ documentation, but the diff leaves unresolved merge conflict markers in FAQ.md.

Concerns

  • FAQ.md contains committed conflict markers around the FAQ section about using Codex or Claude models in Warp, which will render broken documentation until resolved.

Verdict

Found: 0 critical, 1 important, 0 suggestions

Request changes

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Comment thread FAQ.md

Yes. Use whatever you like — Warp's built-in agent, Claude Code, Codex, Gemini CLI, Cursor, others, or no agent at all. The repo ships agent-readable context (skills under [`.agents/skills/`](.agents/skills/), specs under [`specs/`](specs/), and [`WARP.md`](WARP.md)) that any harness supporting these formats can pick up.

<<<<<<< HEAD
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [IMPORTANT] Resolve the merge conflict markers before merging; this marker will be published in the FAQ as-is.

vorporeal added a commit to warpdotdev/repo-sync that referenced this pull request May 6, 2026
## Description

`get_pr_for_commit()` was silently catching `CalledProcessError` and
returning `None` on GitHub API failures. The loop detection code in
`is_sync_originated()` treated this the same as "no PR found," causing
it to fail-open: sync-originated commits were not filtered out, and the
sync workflow created reverse-direction PRs that should never have
existed.

This was the root cause of warpdotdev/warp#9591 (and 3 other PRs created
on 2026-04-30), where public→private sync commits were synced back to
public.

The fix removes the blanket `except` from `get_pr_for_commit()` so API
errors propagate. In the loop detection path this aborts the sync run;
in non-critical call sites (PR description building, reviewer lookup)
the callers now catch and degrade gracefully with logging.

## Testing

Added `test_api_failure_propagates_when_trailer_present` to verify that
`is_sync_originated` raises on API failure instead of returning `False`.
All existing loop detection tests continue to pass.

Co-Authored-By: Oz <oz-agent@warp.dev>
@vorporeal vorporeal closed this May 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed repo-sync:conflict Sync PR has merge conflicts

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant