How riznykst/fen-triadic-synthesis works
FEN is a federated validation node for community-governed linguistic knowledge. Its principal workflow receives extracted entity candidates, forwards them for community governance, records the resulting decision as RDF provenance, and exposes that record through status and export APIs. A separate scaffold stage assists contributors with structuring knowledge; quadratic voting and delegation support community judgment. The graph preserves documented Kafka, ontology, PID, and web-interface capabilities. Some subsystem links rely on README descriptions because their implementation was not excerpted; those limits are reflected in the evidence paths.
Main entry points: validation_consumer/main.py Validation Consumer · sparql_updater.py SPARQL Updater · mock_fen_api/main.py Mock FEN API · webhook.py Decision Webhook
Components 23
Contribution & Scaffold
- Agentic Scaffold
mock_fen_api/scaffold.py - LLM Provider
services/common/llm.py - FEN Ontology
services/common/gfen_ontology.py
Community Governance
- Mock FEN API
mock_fen_api/main.py - Quadratic Voting
mock_fen_api/qv_voting.py - Vote Delegation
mock_fen_api/delegation.py
Federation Pipeline
- FEN Client
services/fen_bridge/fen_client.py - Candidate Bridge
services/fen_bridge/outbound.py - Decision Webhook
services/fen_bridge/webhook.py - Event Contracts
services/common/messages.py - Validation Consumer
services/validation_consumer/main.py - Metrics
services/common/metrics.py - Kafka I/O
services/common/kafka_io.py
Registry & Status
- SPARQL Updater
services/validation_consumer/sparql_updater.py - Graph URI Scheme
services/common/graph_uris.py - PID Scheme
services/common/pid.py - RDF Store
- Status & Export API
services/status_api/main.py - Portal & Widget
web
Other components
- Contributor
- Entity Extractor
- FEN Governance
- Kafka
Connections 26
- Contributor → Agentic Scaffold: requests structuring
- Agentic Scaffold → LLM Provider: requests completion
mock_fen_api/scaffold.py - Agentic Scaffold → FEN Ontology: uses vocabulary
mock_fen_api/scaffold.py - Contributor → Mock FEN API: submits candidates
- Mock FEN API → Quadratic Voting: supports voting
mock_fen_api/main.py - Mock FEN API → Vote Delegation: supports delegation
mock_fen_api/main.py - Mock FEN API → FEN Governance: stands in for
mock_fen_api/main.py - Entity Extractor → Candidate Bridge: emits candidates
- Candidate Bridge → FEN Client: forwards batches
services/fen_bridge/outbound.py - FEN Client → FEN Governance: posts candidates
services/fen_bridge/fen_client.py - FEN Governance → Decision Webhook: sends decisions
- Decision Webhook → Kafka I/O: publishes decisions
services/fen_bridge/webhook.py - Kafka I/O → Kafka: writes messages
- Decision Webhook → Event Contracts: validates decision
services/fen_bridge/webhook.py - Validation Consumer → Kafka I/O: consumes decisions
services/validation_consumer/main.py - Validation Consumer → Event Contracts: validates payload
services/validation_consumer/main.py - Validation Consumer → SPARQL Updater: builds update
services/validation_consumer/main.py - Validation Consumer → Kafka I/O: publishes confirmation
services/validation_consumer/main.py - SPARQL Updater → FEN Ontology: uses predicates
services/validation_consumer/sparql_updater.py - SPARQL Updater → Graph URI Scheme: resolves annotation
services/validation_consumer/sparql_updater.py - SPARQL Updater → PID Scheme: creates record PIDs
services/validation_consumer/sparql_updater.py - SPARQL Updater → RDF Store: updates provenance
services/validation_consumer/sparql_updater.py - Status & Export API → RDF Store: queries provenance
services/status_api/main.py - Portal & Widget → Status & Export API: displays status
- Decision Webhook → Metrics: records metrics
services/fen_bridge/webhook.py - Validation Consumer → Metrics: records metrics
services/validation_consumer/main.py