How sandip-pathe/sira-seil-cockroach-aws works
SIRA helps buyers investigate needs, compare eligible products, review evidence, and obtain approval for protected actions; SEIL lets sellers maintain and publish versioned product evidence and respond to relevant opportunities. The web workspace calls a FastAPI application, which coordinates deterministic decision and qualification logic, bounded agent reasoning, durable state, and background work. The README documents these main boundaries; source-index references support several internal calls, but unsampled modules limit finer-grained wiring.
Main entry points: cognitive_engine.py Cognitive orchestration · qualification_service.py Product qualification · service.py Buyer workflow · qualification_repository.py Qualification repository
Components 27
User experience
- SIRA and SEIL workspaces
apps/web/app/(workspace) - API client
packages/api-client/src/client.ts
Application API
- HTTP routes
services/api/sira_api/routes.py - Qualification routes
services/api/sira_api/qualification_routes.py - Seller routes
services/api/sira_api/seller_routes.py - Exchange routes
services/api/sira_api/exchange_routes.py - Buyer workflow
services/api/sira_api/service.py - Product qualification
services/api/sira_api/qualification_service.py - Seller evidence workflow
services/api/sira_api/seller_service.py - Bilateral exchange
services/api/sira_api/exchange_service.py
Decision and agent runtime
- Cognitive orchestration
services/api/sira_api/cognitive_engine.py - Context assembly
python/agents/sira_agents/context_assembler.py - Cognitive runtime
python/agents/sira_agents/cognitive_runtime.py - Bedrock runtime
python/agents/sira_agents/bedrock_runtime.py - Tool authorization
python/agents/sira_agents/tool_broker.py - Decision graph
python/decision_engine/graph_v1.py - Evidence pipeline
python/domain/evidence_pipeline.py
Durable state
- Workflow repositories
python/persistence/repositories.py - Qualification repository
python/persistence/qualification_repository.py - Cognitive repository
python/persistence/cognitive_repository.py - CockroachDB
Background processing
- Qualification worker
services/worker/sira_worker/qualification.py - Changefeed handler
services/changefeed/sira_changefeed/handler.py - AWS transports
python/integrations/aws_services.py
Other components
- Buyer and seller
- Amazon Bedrock
- AWS queues and storage
Connections 24
- Buyer and seller → SIRA and SEIL workspaces: use
README.md - SIRA and SEIL workspaces → API client: send requests
README.md - API client → HTTP routes: call API
README.md - HTTP routes → Buyer workflow: delegate to
services/api/sira_api/routes.py - Qualification routes → Product qualification: delegate to
services/api/sira_api/qualification_routes.py - Seller routes → Seller evidence workflow: delegate to
services/api/sira_api/seller_routes.py - Exchange routes → Bilateral exchange: serve exchange
- Buyer workflow → Cognitive orchestration: orchestrate reasoning
- Cognitive orchestration → Context assembly: assemble context
services/api/sira_api/cognitive_engine.py - Cognitive orchestration → Cognitive runtime: request decision
services/api/sira_api/cognitive_engine.py - Cognitive runtime → Bedrock runtime: delegate reasoning
python/agents/sira_agents/cognitive_runtime.py - Bedrock runtime → Amazon Bedrock: invoke model
README.md - Cognitive orchestration → Tool authorization: validate tools
services/api/sira_api/cognitive_engine.py - Product qualification → Decision graph: evaluate fit
- Product qualification → Evidence pipeline: process evidence
- Buyer workflow → Workflow repositories: persist workflow
- Product qualification → Qualification repository: persist decisions
- Cognitive orchestration → Cognitive repository: record run
services/api/sira_api/cognitive_engine.py - Workflow repositories → CockroachDB: read and write
README.md - Qualification repository → CockroachDB: commit decisions
README.md - Cognitive repository → CockroachDB: commit runs
README.md - Qualification worker → Qualification repository: lease and persist
services/worker/sira_worker/qualification.py - Changefeed handler → AWS transports: publish changes
- AWS transports → AWS queues and storage: send or store
python/integrations/aws_services.py