# MiroFish Socratic Technical Wiki

> A first-principles map of MiroFish: how uploaded seed material becomes a knowledge graph, agent society, live simulation, and report-driven interaction. This structure is shaped by the requested bundled Compound Engineering wiki workflow, while repository code remains the implementation source of truth; no STRATEGY.md, docs/solutions, or generated wiki context was present in this checkout.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9)
- [GitHub repository](https://github.com/666ghj/MiroFish)

## Repository

- Repository: 666ghj/MiroFish

- Generated: 2026-05-24T18:12:30.327Z
- Updated: 2026-05-24T18:13:22.607Z
- Runtime: Codex CLI
- Format: Socratic Exploration
- Pages: 5

## Pages

- [The First Question](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9/pages/01-the-first-question.md): What is the smallest version of MiroFish: a user question, some seed files, and a provider-neutral runtime that can turn them into a simulated social world?
- [Why Is Uploading Files Not Enough?](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9/pages/02-why-is-uploading-files-not-enough.md): The graph-building page asks why raw documents must become ontology, chunks, tasks, and Zep graph memory before they can support simulation.
- [How Does a Graph Become a Society?](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9/pages/03-how-does-a-graph-become-a-society.md): The preparation stage reframes entities as agents: which nodes are eligible, what profile fields OASIS needs, and where LLM-generated configuration becomes platform-specific behavior without hard-coding one model provider.
- [Why Is Running the Simulation a Process Boundary?](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9/pages/04-why-is-running-the-simulation-a-process-boundary.md): The run stage asks why live simulation leaves Flask request handling: subprocesses, file-based IPC, action logs, SQLite traces, and optional graph-memory updates create the observable boundary.
- [What Can You Now Ask the Sandbox?](https://grok-wiki.com/public/wiki/666ghj-mirofish-5af7beba06b9/pages/05-what-can-you-now-ask-the-sandbox.md): The closing reframe: once graph memory, simulated traces, and agent interviews exist, the report system can reason with tools, assemble evidence section by section, and keep the UI portable across file, repository, or catalog skill sources rather than a single hosted provider.

## Source Files

- `backend/app/__init__.py`
- `backend/app/api/graph.py`
- `backend/app/api/report.py`
- `backend/app/api/simulation.py`
- `backend/app/config.py`
- `backend/app/models/project.py`
- `backend/app/models/task.py`
- `backend/app/services/graph_builder.py`
- `backend/app/services/oasis_profile_generator.py`
- `backend/app/services/ontology_generator.py`
- `backend/app/services/report_agent.py`
- `backend/app/services/simulation_config_generator.py`
- `backend/app/services/simulation_ipc.py`
- `backend/app/services/simulation_manager.py`
- `backend/app/services/simulation_runner.py`
- `backend/app/services/text_processor.py`
- `backend/app/services/zep_entity_reader.py`
- `backend/app/services/zep_graph_memory_updater.py`
- `backend/app/services/zep_tools.py`
- `backend/app/utils/file_parser.py`
- `backend/pyproject.toml`
- `backend/run.py`
- `backend/scripts/action_logger.py`
- `backend/scripts/run_parallel_simulation.py`
- `backend/scripts/run_reddit_simulation.py`
- `backend/scripts/run_twitter_simulation.py`
- `backend/scripts/test_profile_format.py`
- `frontend/src/api/report.js`
- `frontend/src/api/simulation.js`
- `frontend/src/components/Step1GraphBuild.vue`
- `frontend/src/components/Step2EnvSetup.vue`
- `frontend/src/components/Step3Simulation.vue`
- `frontend/src/components/Step4Report.vue`
- `frontend/src/components/Step5Interaction.vue`
- `frontend/src/router/index.js`
- `frontend/src/views/InteractionView.vue`
- `package.json`
- `README.md`