Adding new Nodes

🚀 STEMgraph API - Version 2.0

Derived from v2.0.3

🔥 Major Enhancements & New Features

This release introduces significant refactoring and enhanced functionality for improved reliability, usability, and performance. The API is now running at:

🔗 STEMgraph API Documentation

---

🆕 Key Additions & Changes

✅ New Dependency Resolution Endpoints

• GET /builds_on_list/{uuid} - Returns all UUIDs a node depends on as a flat list.
• GET /builds_on_tree/{uuid} - Returns dependency relationships as a nested tree.

✅ Typer-based CLI Wrapper for API Execution

• Introduced STEMgraph_API.py, which wraps FastAPI execution using Typer.
• Added --test flag to validate Neo4j connectivity before launching the API.

✅ Improved API Startup Reliability

• Health check now runs on startup, retrying until Neo4j is available.
• API will not start until Neo4j is successfully connected.

✅ Docker & Deployment Enhancements

• Dockerfile now runs the health check (--test) before launching the API to ensure stable deployments.
• Updated docker-compose.yml to use latest tag for better version management.

✅ Improved Logging & Debugging

• Enhanced logging for API startup, health checks, and database errors.
• Standardized logs using Uvicorn for consistency across deployments.

---

🛠 How to Upgrade

If using Docker:

docker pull stemgraph_api:latest
docker stack deploy --compose-file docker-compose.yml stemgraph_stack

If running locally:

git pull origin master
python app/STEMgraph_API.py --test  # Verify Neo4j connection
python app/STEMgraph_API.py  # Start the API

---

📢 Discussion & Contribution

💬 Share your feedback in our GitHub Discussions.
🚀 Contributions are welcome! Contact sboekelmann@ep1.rub.de for more details.

---

🎯 Upcoming Features

✅ Graph retrieval in multiple formats.
✅ Shortest path computation between nodes.
✅ Auto-generated PDF documentation for node metadata.

This version represents a major step forward in API stability and usability. Thanks for using STEMgraph! 🚀