How rahesh-supersemantics/x-verba-governed-semantic-search works
This is a web application for semantic search over a knowledge base, with VSL governance controlling whether results are served automatically, routed for human review, or suspended. The main workflow runs from the user interface through the API, retrieval, governance decision, and an approved side effect. Separate governance endpoints expose status, ledger, audit, review queue, and human-authorized resume; a terminal CLI provides conformance, integrity, audit, and certification. Source excerpts show core calls, while some UI and route behavior is supported by the README rather than sampled frontend code.
Main entry points: app.py FastAPI routes · index.html Search UI · actions.py Search actions · gates.py Governance gates
Components 13
Web interface
- Search UI
frontend/index.html
Search service
- FastAPI routes
backend/app.py - Semantic retrieval
backend/model.py - Search artifacts
artifacts - Search actions
backend/actions.py
Governance
- Governance policy
governance/policy.py - Governance gates
governance/gates.py - Audit ledger
governance/ledger.py
Review and audit
- Served-answer log
backend/actions.py - Human review queue
backend/actions.py - Audit CLI
governance/audit_cli.py
Other components
- Search user
- Human reviewer
Connections 17
- Search user → Search UI: submits query
README.md - Search UI → FastAPI routes: calls search API
README.md - FastAPI routes → Semantic retrieval: retrieves candidates
backend/app.py - Semantic retrieval → Search artifacts: loads model and documents
backend/model.py - FastAPI routes → Governance gates: requests decision
backend/app.py - Governance gates → Governance policy: enforces constructs
governance/gates.py - Governance gates → Audit ledger: records decisions
governance/gates.py - FastAPI routes → Search actions: commits approved outcome
README.md - Search actions → Served-answer log: appends served record
backend/actions.py - Search actions → Human review queue: creates review ticket
backend/actions.py - Human review queue → Human reviewer: awaits review
README.md - Human reviewer → Search UI: reviews ticket
- Search UI → FastAPI routes: requests resume
README.md - FastAPI routes → Governance gates: requests re-enablement
backend/app.py - FastAPI routes → Audit ledger: reads audit and history
backend/app.py - FastAPI routes → Search actions: reads review queue
backend/app.py - Audit CLI → Audit ledger: verifies and audits
governance/audit_cli.py