How dagztagz/dagztagz-hypothesis-engine works
DagzTagz Hypothesis Engine is a single-workflow scientific research aid. A researcher submits a topic through the CLI; the workflow optionally retrieves passages from local files, builds a background brief, generates hypotheses, checks each adversarially, and suggests experiments or simulations. Results are structured and displayed or saved, with optional local audit records. The README documents these capabilities; sampled workflow excerpts are incomplete, so internal links are limited to the documented flow and visible retrieval behavior.
Main entry points: workflow.py Workflow orchestration · cli.py Command-line interface · llm.py Grok API client · audit.py Audit logging
Components 17
User interface
- Command-line interface
src/hypothesis_engine/cli.py
Research workflow
- Workflow orchestration
src/hypothesis_engine/workflow.py - Background brief
src/hypothesis_engine/workflow.py - Hypothesis generation
src/hypothesis_engine/workflow.py - Multi-check verification
src/hypothesis_engine/workflow.py - Test suggestions
src/hypothesis_engine/workflow.py - Scientific prompts
src/hypothesis_engine/prompts.py - Structured results
src/hypothesis_engine/models.py
Model and retrieval
- Runtime settings
src/hypothesis_engine/config.py - Grok API client
src/hypothesis_engine/llm.py - Local retrieval
src/hypothesis_engine/retrieval.py
Local records
- Audit logging
src/hypothesis_engine/audit.py - Topic encryption
src/hypothesis_engine/audit_crypto.py - Local output and logs
Other components
- Researcher
- xAI Grok API
- Research files
Connections 21
- Researcher → Command-line interface: submits topic
- Command-line interface → Runtime settings: loads settings
- Command-line interface → Workflow orchestration: runs workflow
- Workflow orchestration → Local retrieval: retrieves passages
- Research files → Local retrieval: provides files
- Workflow orchestration → Background brief: builds brief
- Workflow orchestration → Hypothesis generation: generates hypotheses
- Workflow orchestration → Multi-check verification: checks hypotheses
- Workflow orchestration → Test suggestions: suggests tests
- Workflow orchestration → Scientific prompts: uses templates
- Workflow orchestration → Grok API client: requests completions
- Grok API client → Runtime settings: reads credentials
- Grok API client → xAI Grok API: sends prompts
- xAI Grok API → Grok API client: returns responses
- Workflow orchestration → Structured results: validates results
- Workflow orchestration → Local retrieval: creates mock passages
- Command-line interface → Audit logging: records run
- Audit logging → Topic encryption: encrypts topic
- Audit logging → Local output and logs: writes audit log
- Command-line interface → Local output and logs: writes output
- Command-line interface → Researcher: displays results