Metadata-Version: 2.4
Name: the-steward
Version: 0.2.2
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.
        
           EXCEPTION — VENDORED RUNNER FILES. The Software's gha mode installs a small set of runner files
           into a repository You control (the files placed under `.steward/` and `.github/workflows/`, the
           "Vendored Runner Files"). Hosting those files in that repository — including a repository that is
           publicly visible — is permitted and is not a breach of §3(a) or §3(b). This is a hosting
           permission only, not a grant to anyone else: third parties acquire no license to the Vendored
           Runner Files from their visibility, may not use, copy, modify, or redistribute them, and You may
           not present them as available for reuse. The accompanying NOTICE file must remain with them
           (§3(d)). All §3 restrictions continue to apply to every other part of the Software.
        
        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
pipx ensurepath               # first pipx package? this puts `steward` on your PATH (then open a new shell)
steward init                  # preflight + economy on-ramp + your local dashboard
```
If `steward` says "command not found", that's the PATH step above — run `pipx ensurepath` and open a
new terminal; the tool is installed, your shell just can't see `~/.local/bin` yet.
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
```

## No always-on machine? Run it in your repo's own GitHub Actions
Local mode assumes a box that stays on. If your project deploys elsewhere and your machine sleeps,
a repo can instead run the whole loop in **its own GitHub Actions** — the watch is a scheduled
workflow, investigation runs in your repo's real CI, results live on a `steward-state` branch, and
verified fixes arrive as pull requests gated by *your* checks.

```bash
steward track <repo> --mode gha        # guided install: preflight → config → workflow
steward track <repo> --mode gha --dry  # print the full plan first, change nothing
```

The install tells you the steps only you can do (set the inference credential as a repo secret,
commit and push the workflow it writes, dispatch the first run). Notes: your repo should be
**private** — the install writes Steward runner files into it, and shipping logs to a public repo is
refused; per-repo Actions minutes are consumed on your account; and the schedule is best-effort
(GitHub cron), so think hours, not seconds.

## 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).
