How moonlin1213/cove-pet-nest works
Cove Pet Nest is a local pet-care application that integrates with a user’s AI through stdio MCP or authenticated HTTP. The principal workflow is to adopt a pet, build pantry food from host-reported conversation contributions, and record care; for fantasy eggs, growth and relationship signals shape a frozen hatch description that can be sent to an optional image service. The local web UI and MCP expose care, while HTTP also handles host events and image imports. SQLite-backed state supports receipts and retries. Some UI and backup internals were not sampled; documented capabilities are included without assuming their implementation details.
Main entry points: http.py HTTP API · cove_pet_nest/service.py Nest service · store.py SQLite pet store · images/service.py Image jobs
Components 19
User interfaces
- Local web UI
src/cove_pet_nest/web - HTTP API
src/cove_pet_nest/http.py - MCP tools
src/cove_pet_nest/mcp_server.py - Service entry
src/cove_pet_nest/cli.py - Request contracts
src/cove_pet_nest/contracts.py
Pet domain
- Nest service
src/cove_pet_nest/service.py - Adoption and care
src/cove_pet_nest/store.py - Hatch preparation
src/cove_pet_nest/growth.py
Contribution signals
- Usage ledger
src/cove_pet_nest/ledger.py - Relationship signals
src/cove_pet_nest/relationships.py
Images and hatching
- Image jobs
src/cove_pet_nest/images/service.py - Image validation
src/cove_pet_nest/images/processing.py - Image provider transport
src/cove_pet_nest/images/transport.py
Local data
- SQLite pet store
src/cove_pet_nest/store.py - Local credentials
src/cove_pet_nest/auth.py - Backup and restore
src/cove_pet_nest/backup.py
Other components
- Pet owner
- Host application
- Image generation service
Connections 28
- Pet owner → Local web UI: uses
README.md - Local web UI → HTTP API: requests
- Host application → HTTP API: reports events
README.md - Service entry → Nest service: builds
src/cove_pet_nest/cli.py - Service entry → HTTP API: serves
src/cove_pet_nest/cli.py - Service entry → MCP tools: runs
src/cove_pet_nest/cli.py - HTTP API → Local credentials: checks credentials
src/cove_pet_nest/http.py - HTTP API → Request contracts: validates requests
src/cove_pet_nest/http.py - HTTP API → Nest service: routes pet actions
src/cove_pet_nest/http.py - HTTP API → Usage ledger: records usage
src/cove_pet_nest/http.py - HTTP API → Relationship signals: records signals
src/cove_pet_nest/http.py - HTTP API → Image jobs: imports assets
src/cove_pet_nest/http.py - HTTP API → Nest service: ticks worker
src/cove_pet_nest/http.py - MCP tools → Request contracts: validates tool input
src/cove_pet_nest/mcp_server.py - MCP tools → Nest service: calls pet actions
src/cove_pet_nest/mcp_server.py - Nest service → Adoption and care: adopts and cares
src/cove_pet_nest/service.py - Nest service → Image jobs: queues and runs
src/cove_pet_nest/service.py - Nest service → Hatch preparation: prepares hatch
src/cove_pet_nest/service.py - Nest service → SQLite pet store: reads state
src/cove_pet_nest/service.py - Image jobs → Image validation: validates images
src/cove_pet_nest/images/service.py - Image jobs → Image provider transport: requests generation
src/cove_pet_nest/images/service.py - Image provider transport → Image generation service: sends prompt
src/cove_pet_nest/images/transport.py - Image jobs → SQLite pet store: records job state
src/cove_pet_nest/images/service.py - Hatch preparation → SQLite pet store: reads signals and care
src/cove_pet_nest/growth.py - Usage ledger → SQLite pet store: credits pantry
src/cove_pet_nest/ledger.py - Relationship signals → SQLite pet store: stores signals
src/cove_pet_nest/relationships.py - Service entry → Backup and restore: creates backup
src/cove_pet_nest/cli.py - Backup and restore → SQLite pet store: backs up database
src/cove_pet_nest/backup.py