How baitc-hacks/hack-4a3a9b1c-vibeops works
Firebird is an event-contractor recommendation assistant. Its main workflow gathers and confirms event requirements, filters and ranks the vendor catalog, then returns up to three evidence-backed recommendations; users can also request preference comparisons or apply date/budget alternatives. The README documents the full workflow, while the sampled source confirms key UI, API, assistant, catalog, and decision-support responsibilities; unsampled orchestration links are included only where documented.
Main entry points: App.tsx Search workspace · recommend.ts Recommendation flow · assistant-brief.ts Requirement extraction · api.ts API client
Components 19
User experience
- Search workspace
client/src/App.tsx - Requirements dialog
client/src/Assistant.tsx - Alternative controls
client/src/DecisionSupport.tsx - API client
client/src/api.ts
Request workflow
- Express API
server/app.ts - Recommendation flow
server/recommend.ts - Query validation
server/validation.ts
Catalog selection
- Vendor catalog
server/catalog.ts - Vendor CSV
data/vendors.csv - Filter and rank
server/matching.ts - Date and budget options
server/alternatives.ts
AI and evidence
- Requirement extraction
server/explanations/assistant-brief.ts - Preference comparison
server/explanations/assistant-compare.ts - Evidence explanations
server/explanations/index.ts - Quote verification
server/explanations/evidence.ts - Model adapter
server/explanations/provider.ts - Exchange rates
server/explanations/exchange-rates.ts
Other components
- Event planner
- OpenAI Responses API
Connections 32
- Event planner → Requirements dialog: describes event
- Requirements dialog → API client: requests brief
- Search workspace → API client: requests search
- API client → Express API: sends API request
- Express API → Requirement extraction: dispatches brief
- Requirement extraction → Vendor catalog: reads options
- Requirement extraction → Query validation: validates draft
- Requirement extraction → Exchange rates: converts currency
- Requirement extraction → OpenAI Responses API: requests extraction
- Requirement extraction → Requirements dialog: returns draft
- Event planner → Search workspace: confirms conditions
- Express API → Recommendation flow: dispatches search
- Recommendation flow → Query validation: validates query
- Recommendation flow → Vendor catalog: uses vendor data
- Vendor catalog → Vendor CSV: loads records
- Recommendation flow → Filter and rank: selects candidates
- Recommendation flow → Evidence explanations: builds explanations
- Evidence explanations → Model adapter: requests evidence
- Model adapter → OpenAI Responses API: requests quotes
- Evidence explanations → Quote verification: verifies quotes
- Recommendation flow → Date and budget options: computes alternatives
- Date and budget options → Filter and rank: tests conditions
- Express API → Preference comparison: dispatches comparison
- Preference comparison → Query validation: validates query
- Preference comparison → Filter and rank: selects candidates
- Preference comparison → OpenAI Responses API: requests comparison
- Express API → API client: returns results
- API client → Search workspace: provides results
- Search workspace → Alternative controls: shows alternatives
- Search workspace → API client: requests comparison
- Alternative controls → Search workspace: applies alternative
- Search workspace → Event planner: shows recommendations