Lib.rs

REST + WebSocket API service for Vibe-Graph.

This crate provides a clean API layer that can be consumed by any frontend. It separates data serving from visualization concerns.

Endpoints

Graph & WebSocket API (stateful, for visualization)

• GET /api/health - Health check with node/edge counts
• GET /api/graph - Full SourceCodeGraph JSON
• GET /api/graph/nodes - Nodes only
• GET /api/graph/edges - Edges only
• GET /api/graph/metadata - Graph metadata
• GET /api/git/changes - Current git change snapshot
• GET /api/ws - WebSocket for real-time updates

Operations API (stateless, for CLI-like operations)

• POST /api/ops/sync - Sync a codebase
• GET /api/ops/sync?source=... - Sync with query params
• POST /api/ops/graph - Build source code graph
• GET /api/ops/graph?path=... - Build graph with query params
• GET /api/ops/status?path=... - Get workspace status
• GET /api/ops/load?path=... - Load project from .self
• DELETE /api/ops/clean?path=... - Clean .self folder
• GET /api/ops/git-changes?path=... - Get git changes

Git Commands API (for executing git operations)

• POST /api/git/cmd/add - Stage files
• POST /api/git/cmd/commit - Create commit
• POST /api/git/cmd/reset - Unstage files
• GET /api/git/cmd/branches - List branches
• POST /api/git/cmd/checkout - Switch branch
• GET /api/git/cmd/log - Commit history
• GET /api/git/cmd/diff - Get diff

Usage

use vibe_graph_api::{create_api_router, create_api_state, create_ops_router};
use vibe_graph_ops::{Config, OpsContext};

// For visualization server with pre-loaded graph
let graph = vibe_graph_core::SourceCodeGraph::default();
let state = create_api_state(graph);
let router = create_api_router(state);

// For operations API
let config = Config::load().unwrap();
let ctx = OpsContext::new(config);
let ops_router = create_ops_router(ctx);