io.github.Rosentic/rosentic
Deterministic cross-branch conflict detection for AI coding agents
Open source Open in the app JSON README (API)
About
Deterministic cross-branch conflict detection for AI coding agents
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- rosentic
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-05-20T03:01:43Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 03:02:12
- Updated
- 2026-08-29 03:02:12
- Origin id
io.github.Rosentic/rosentic
README
# Rosentic - Cross-Branch Merge Safety
Rosentic checks whether your active branches are compatible with each other before merge. It detects broken function signatures, HTTP route conflicts, and schema mismatches across 15+ languages using deterministic AST analysis.
**This is not AI code review.** Rosentic finds structural contract conflicts that would cause runtime failures after merge - the kind of breaks that tests don't catch because they only run on one branch at a time.
## Install
```bash
pip install rosentic-mcp
```
Then add to your editor's MCP config:
```json
{
"mcpServers": {
"rosentic": {
"command": "rosentic-mcp",
"args": [],
"env": {}
}
}
}
```
Works with Cursor, Claude Code, Cline, Windsurf, and any editor that supports MCP.
## What it does
Rosentic gives your AI coding agent three MCP tools:
| Tool | Purpose |
|------|---------|
| `check_conflicts` | Scan a repo for cross-branch contract conflicts |
| `explain_conflict` | Explain a specific finding and what to do about it |
| `list_branches` | List active branches so the agent can choose what to scan |
### Example conflicts Rosentic catches
- Branch A adds a required parameter to `createOrder()`. Branch B calls `createOrder()` with the old signature. Both pass CI. Merge breaks production.
- Branch A changes `POST /api/users` to require `email` in the request body. Branch B's frontend still sends the old payload.
- Branch A removes a field from a GraphQL type that Branch B's query depends on.
## How it works
Before you push, open a PR, or merge, your agent runs a cross-branch compatibility check. It calls `check_conflicts`, which scans your repo's branch heads using tree-sitter AST parsing and reports any conflicts.
No code leaves your machine. The scan runs locally against your git repo.
## Compared to Semgrep Guardian
Semgrep Guardian checks each file for security vulnerabilities and code issues. Rosentic checks whether your branches are compatible with each other. They solve different problems and work well together:
- **Semgrep Guardian**: "Is this code safe and correct on its own?"
- **Rosentic**: "Will this branch break other branches when merged?"
## Links
- [Rosentic website](https://rosentic.com)
- [GitHub Action](https://github.com/marketplace/actions/rosentic-merge-conflict-detection)
- [PyPI package](https://pypi.org/project/rosentic-mcp/)