@tushell/kinship-graph

The relational kinship graph of the Tushell Portal: people, entities, projects, concepts, and ceremonies connected by relations like creates, witnesses, teaches, and nurtures.

Implements rispecs/09-kinship/relational-graph.rispec.md.

What's inside

• Types — KinshipNode, KinshipEdge, KinshipGraph, filters, analysis, layout types, plus NODE_TYPE_META / RELATION_META / DIRECTION_META display metadata and type guards
• Pure graph functions — filterKinshipGraph() and analyzeKinshipGraph() operate on in-memory graphs with no I/O
• Storage-agnostic CRUD — createKinshipStore({ store }) gives node/edge CRUD, full-graph reads, and depth-limited getNodeNeighborhood() BFS over any store with a Redis-shaped get/set/del/sadd/srem/smembers surface (an @upstash/redis client works directly)

Usage

import { createKinshipStore, analyzeKinshipGraph } from "@tushell/kinship-graph"
import { Redis } from "@upstash/redis"

const kinship = createKinshipStore({
  store: Redis.fromEnv(),
  generateId: () => nanoid(),        // optional, defaults to crypto.randomUUID
  parseNode: KinshipNodeSchema.parse, // optional Zod validation
})

const graph = await kinship.getKinshipGraph()
const analysis = analyzeKinshipGraph(graph)

No runtime dependencies.