# PlanetGraph Recipes: Warm Introductions

This file describes one example use case implemented on top of PlanetGraph's generic graph model.

## Generic model reminder
- nodes represent domain entities
- edges represent relationships between entities
- properties can be attached to either nodes or edges

## Recipe 1: Shared employer bridge
**Intent**  
- Find people connected through a common company.

**Cypher**  
```cypher
MATCH (source:Person)-[:worked_for]->(company:Company)<-[:worked_for]-(target:Person)
RETURN source, company, target
LIMIT 100
```

## Recipe 2: API-based edge filtering by node types
**Intent**  
- Retrieve only people-to-company work edges.

**HTTP**  
```
GET /api/v1/edges?type=worked_for&source_type=Person&target_type=Company&limit=100
```

## Recipe 3: Expand one person's employer neighbors
**Intent**  
- Explore candidate intro paths around a starting person node.

**Cypher**  
```cypher
MATCH (p:Person)-[:worked_for]->(c:Company)<-[:worked_for]-(other:Person)
RETURN p, c, other
LIMIT 100
```

## Validation notes
- If results are empty, first inspect available edge types using `GET /api/v1/edges`.
- Confirm case sensitivity for type labels in your dataset (Person vs person).