Metadata-Version: 2.4
Name: the-steward
Version: 0.1.0
Summary: The Steward — a continuously-watching guardian that spends intelligence only on novelty, investigates it to a decision-ready conclusion, verifies against reality over time, and surfaces exactly what a human or an agent needs. The flagship inferroute application.
License: The Steward — Evaluation License
        Copyright (c) 2026 Henry Declety. All rights reserved.
        
        1. DEFINITIONS
           "Software" means The Steward — this package and all accompanying code, scripts, agents, and
           documentation. "You" means the individual or entity granted access under this license.
        
        2. GRANT (LIMITED, EVALUATION-ONLY)
           Subject to your compliance with this license, Henry Declety grants You a personal, non-exclusive,
           non-transferable, non-sublicensable, revocable license to install and run the Software on machines
           You control, solely to evaluate it for Your own internal use. No other rights are granted.
        
        3. RESTRICTIONS
           You may NOT, in whole or in part: (a) redistribute, publish, sublicense, sell, rent, or otherwise
           make the Software available to any third party; (b) fork, mirror, or create derivative works for
           distribution; (c) use the Software to provide a service to third parties or for any commercial
           purpose; (d) remove or alter any proprietary notices; (e) reverse-engineer except to the extent that
           restriction is prohibited by applicable law.
        
        4. OWNERSHIP
           The Software is licensed, not sold. Henry Declety retains all right, title, and interest in and to the
           Software, including all intellectual property rights. Any feedback or contributions You provide may
           be used by Henry Declety without restriction or obligation, and You assign to Henry Declety all rights
           in any such contributions.
        
        5. THIRD-PARTY / RUNTIME SERVICES
           The Software routes inference through inferroute (the "ir" economy lane); Your use of that service is
           governed by its own terms. The Software is not a license to any inferroute service or credits.
        
        6. TERM & TERMINATION
           This license is effective until terminated. It terminates automatically if You breach any term, and
           Henry Declety may revoke it at any time. On termination You must stop using and delete all copies of
           the Software.
        
        7. NO WARRANTY
           THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
           LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
        
        8. LIMITATION OF LIABILITY
           IN NO EVENT SHALL Henry Declety BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY (INCLUDING
           DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, OR LOSS OF DATA OR PROFITS) ARISING FROM OR IN
           CONNECTION WITH THE SOFTWARE OR ITS USE. The Software runs autonomously and may modify files in
           repositories You point it at; You are responsible for the repositories and machines You authorize it
           to act on.
        
        9. GOVERNING LAW
           This Agreement is governed by and construed in accordance with the laws of France, without regard to
           its conflict-of-laws rules. The courts of Paris, France shall have exclusive jurisdiction over any
           dispute arising out of or relating to this Agreement or the Software, subject to any mandatory
           provisions of law that apply to a consumer in their country of residence.
        
Classifier: License :: Other/Proprietary License
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# The Steward

**A guardian that watches your repos overnight, spends intelligence only on what's new, investigates
it to a decision, and hands you a short morning brief — not a firehose.**

The Steward sits beside your projects. Most of the time it does nothing but watch (cheap, local, no
inference). When something genuinely changes — a new error in your logs, a risky commit, a regression —
it spins up an isolated worktree, investigates with an LLM, verifies the finding against reality, and
either fixes it on a branch or writes it up. In the morning you read one digest.

> **Status: early access for friends.** Linux (and WSL2) today; macOS scheduling is in progress.
> Install with `pipx install the-steward`. See [INSTALL](#install).

## What it does
- **Watches** your tracked git repos + their logs locally, on a timer. No inference until something is new.
- **Investigates** novelty in a throwaway git worktree — never your working tree, never your branches.
- **Verifies** findings against the real repo (it won't surface a fix for a file that doesn't exist).
- **Scrubs** secrets out of anything before it leaves your machine for the model.
- **Briefs** you each morning — read it in the **dashboard** (`localhost:5057`) or `steward review`.

## Requirements
- Linux with `systemd --user` (or WSL2 with systemd enabled). *macOS isn't supported yet — `steward init`
  will stop with that message.*
- Python ≥ 3.10, `git`, `tmux`, and `bash`.
- **Claude Code** — the `claude` CLI is the agent harness the Steward drives to investigate; `steward init`
  hard-checks for it. Install: https://claude.com/code
- An **inferroute** account for the **economy lane** (the recommended way to run — cheap, always-on
  compute that keeps the overnight watch affordable):
  1. `pipx install 'inferroute>=0.3.28'`  *(0.3.28+ required — it honors the Steward's write-scoping)*
  2. Sign up at **https://inferroute.ai** — early-access friends start with a small **$5 credit
     headstart** on their own account; top up with your own credits once you've kicked the tires.
  3. `ir login` (paste your key) — or `ir setup` for the guided first-run.

  *Escape hatch:* you can instead bring your own Anthropic/Claude key (`ir anthropic` / BYO), but the
  economy lane is what makes always-on watching cheap, so it's the default.

## Install
The package is on PyPI (proprietary, licensed for evaluation — see [License](#license)):
```bash
pipx install the-steward      # or: pip install the-steward  into a venv
steward init                  # preflight + economy on-ramp + your local dashboard
```
Update any time with `pipx upgrade the-steward`.
`steward init` runs a preflight (checks your tools + that your inferroute economy login is funded, with
the exact fix for anything missing), then installs your **local dashboard** and points you to it.

**Pick your projects in the dashboard** — `http://localhost:5057` — where you discover repos, see each
one's fit (evaluated for you), and start watching the ones you want. That's the main way to drive it.
```bash
steward review            # the morning digest (auto-runs each morning; run any time)
steward status <repo>     # a repo's health from the terminal
# headless / no browser? pick from the terminal instead:
steward discover          # list watchable repos
steward track <repo>      # watch one   ·   steward untrack <repo> to stop   ·   steward onboard for a TUI
```

## Privacy
- The watch loop is **fully local** — zero inference, zero egress.
- When an investigation runs, context is **scrubbed of secrets** before it reaches the model.
- **Fleet telemetry** (run/turn metadata to improve the tuning loops) is configurable:
  `steward` shows the setting at setup; turn it off to ship nothing. *(See [INSTALL](#install) for the
  current default and exactly what's sent.)*

## What it is NOT (yet)
- Not open source — it's on PyPI, but under a proprietary **evaluation** license: run it on your own
  machines, but don't redistribute, fork, or use it commercially.
- Not an OS-level sandbox — point it at your own repos, not untrusted code. Agents run in throwaway
  worktrees, but a misbehaving agent with shell access could still read files in your home dir.

## License
Proprietary — © 2026 Henry Declety. Licensed to early-access users for **evaluation only**: you may run it
on your own machines, but not redistribute, fork, or use it commercially. See [LICENSE](LICENSE).
