Metadata-Version: 2.4
Name: shepherds-console
Version: 0.1.2
Summary: Single-pane operations for working animal infrastructure
Author: SuperInstance
License-Expression: MIT
Project-URL: Homepage, https://github.com/SuperInstance/shepherds-console
Project-URL: Repository, https://github.com/SuperInstance/shepherds-console
Project-URL: Issues, https://github.com/SuperInstance/shepherds-console/issues
Keywords: operations,dashboard,working-animal-architecture,infrastructure
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: rich
Requires-Dist: rich>=13.0; extra == "rich"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: rich>=13.0; extra == "dev"
Dynamic: license-file

# 🐑 The Shepherd's Console

**Single-pane operations for working animal infrastructure.**

The Shepherd's Console is the operations dashboard for a human operator managing working animal infrastructure — what your working animals are doing, what fences are active, what pastures are running, conservation budget status.

## What It Shows

| Panel | Description |
|-------|-------------|
| **Pastures** | PLATO rooms where working animals operate — status, occupancy, throughput |
| **Fences** | Conservation enforcers — active guardrails, violation counts, enforcement actions |
| **Kennel** | Flux registry policies — registered working animals, their roles, health |
| **Audit Trail** | Recent events — what happened, when, who did it |

## Quick Start

```bash
pip install shepherds-console

# Terminal dashboard
shepherds-console

# Web dashboard
shepherds-console --web --port 8080
```

## Programmatic Use

```python
from shepherds_console import ShepherdsConsole

console = ShepherdsConsole()

# Register a pasture
console.add_pasture("translation-farm", mode="PLATO", capacity=10)

# Register a fence (conservation enforcer)
console.add_fence("token-budget", limit=50000, action="throttle")

# Register a working animal
console.add_animal("translator-7", pasture="translation-farm", role="flux")

# Get status
print(console.status())

# Render
print(console.render_terminal())
```

## Architecture

```
┌─────────────────────────────────────────────────────┐
│              The Shepherd's Console                  │
├─────────────┬───────────────┬───────────┬───────────┤
│   Pastures  │    Fences     │  Kennel   │  Audit    │
│  (PLATO)    │ (Enforcers)   │ (Flux)    │  Trail    │
├─────────────┼───────────────┼───────────┼───────────┤
│ Room status │ Guardrails    │ Registry  │ Events    │
│ Occupancy   │ Violations    │ Policies  │ Timeline  │
│ Throughput  │ Budget left   │ Health    │ Severity  │
└─────────────┴───────────────┴───────────┴───────────┘
```

## Conceptual Model

This is part of **Working Animal Architecture** — a system where AI workers are treated as working animals that need pastures (workspaces), fences (guardrails), and a kennel (registry).

- **Pasture** — A bounded workspace (PLATO room) where animals graze on tasks
- **Fence** — A conservation enforcer that prevents overconsumption
- **Kennel** — The registry where animals are tracked, vetted, and dispatched
- **Shepherd** — The human operator who watches the console

## License

MIT
