Metadata-Version: 2.4
Name: fishinglog-agent
Version: 0.1.0
Summary: Captain's Mate for fishinglog.ai - PLATO-based fishing log agent
Project-URL: Homepage, https://github.com/SuperInstance/fishinglog-agent
Project-URL: Repository, https://github.com/SuperInstance/fishinglog-agent
Project-URL: Issues, https://github.com/SuperInstance/fishinglog-agent/issues
Author-email: Cocapn Fleet <fleet@cocapn.com>
License-Expression: MIT
Keywords: fishing,fleet,logging,plato
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# PLATO Fishing Log Agent - Captain's Mate for fishinglog.ai

A git-agent pattern for fishing logs. Every fishing session is a committed tile to PLATO.

## Features

- **Sonar data logging** → writes functional tiles to PLATO
- **Natural language queries** → "where were tuna last Tuesday?" → answer from PLATO
- **Session tracking** → each fishing trip is a committed tile with location, depth, species, catch
- **Vessel accumulation** → learns from past sessions over time

## Architecture

- **PLATO room**: `fishinglog-ai` — stores all fishing tiles
- **Tile schema**: timestamp, latitude, longitude, depth_meters, species, catch_count, session_id, notes
- **Agent pattern**: git-agent writes tiles, reads tiles to answer questions

## Quick Start

```bash
pip install fishinglog-agent
```

### Log a fishing session

```python
from fishinglog_agent import FishingLogAgent

agent = FishingLogAgent()
agent.log_session(
    latitude=41.5,
    longitude=-71.3,
    depth_meters=45,
    species="tuna",
    catch_count=12,
    notes="Good catch near the shipping lanes"
)
```

### Query past catches

```python
# Where were tuna last Tuesday?
results = agent.query(species="tuna", days_back=7)

# What species at this location?
results = agent.query(latitude=41.5, longitude=-71.3, radius_km=5)
```

## Development

```bash
git clone https://github.com/SuperInstance/fishinglog-agent.git
cd fishinglog-agent
pip install -e .
pytest
```

## License

MIT