steward-cli 0.3.1__tar.gz → 0.3.2__tar.gz

{steward_cli-0.3.1 → steward_cli-0.3.2}/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/). This project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.2] - 2026-04-26
+
+### Changed
+
+- `README.md` — document `steward doctor`. The previous Usage section listed only `steward show`, leaving the second verb (added in 0.2.0 as `verify`, renamed in 0.3.0, refined in 0.3.1) invisible to anyone who only reads the README. Adds both scopes (`--scope self` default, `--scope siblings`), the `--json` / `--check` flags, the `--apply` roadmap caveat, and cross-links to `docs/sibling-pattern.md` (the contract `doctor` honors) and `docs/perfect-patient.md` (the auto-generated corpus baseline).
+
 ## [0.3.1] - 2026-04-26
 
 ### Changed

{steward_cli-0.3.1 → steward_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steward-cli
-Version: 0.3.1
+Version: 0.3.2
 Summary: Steward — aligns and maintains resident agents across Culture projects.
 Project-URL: Homepage, https://github.com/agentculture/steward
 Project-URL: Issues, https://github.com/agentculture/steward/issues
@@ -50,6 +50,30 @@ steward show ../daria
 `.claude/skills/agent-config/scripts/show.sh`. The skill remains the canonical
 implementation; the CLI is the typed entry point.
 
+```bash
+# Diagnose a single sibling repo against the AgentCulture sibling pattern
+# (portability + skills-convention checks). Exits non-zero on findings.
+steward doctor ../culture
+steward doctor ../culture --json --check portability
+
+# Walk every culture.yaml in the workspace, score each declared agent
+# against the corpus baseline, and write per-repo feedback into
+# <target>/docs/steward/steward-suggestions.md. Diagnostic-only.
+steward doctor --scope siblings
+```
+
+`steward doctor` is read-only diagnosis. `--scope self` (default) runs the
+single-repo invariant checks against `TARGET`. `--scope siblings` walks every
+`culture.yaml` in the workspace, refreshes
+[`docs/perfect-patient.md`](docs/perfect-patient.md) from the corpus, and
+writes per-target feedback into each sibling's
+`docs/steward/steward-suggestions.md`. The repair mode (`--apply`) is on the
+roadmap but not implemented yet.
+
+See [`docs/sibling-pattern.md`](docs/sibling-pattern.md) for the contract
+`doctor` honors and [`docs/perfect-patient.md`](docs/perfect-patient.md) for
+the auto-generated corpus baseline.
+
 See [`CLAUDE.md`](CLAUDE.md) for project-shape, build/test/publish details, and
 the skills convention.
 

steward_cli-0.3.2/README.md

@@ -0,0 +1,64 @@
+# steward
+
+Steward aligns and maintains resident agents across Culture projects.
+
+## Install
+
+```bash
+pip install steward-cli
+```
+
+Or, with [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv tool install steward-cli
+```
+
+## Usage
+
+```bash
+steward --version
+steward --help
+
+# Show a Culture agent's full configuration in one view
+# (CLAUDE.md + the parallel culture.yaml + .claude/skills/ index).
+# Run from inside a Steward checkout — the command finds the agent-config
+# skill script via a walk-up from the current working directory.
+steward show ../culture
+steward show ../daria
+```
+
+`steward show` is a thin wrapper over the `agent-config` skill at
+`.claude/skills/agent-config/scripts/show.sh`. The skill remains the canonical
+implementation; the CLI is the typed entry point.
+
+```bash
+# Diagnose a single sibling repo against the AgentCulture sibling pattern
+# (portability + skills-convention checks). Exits non-zero on findings.
+steward doctor ../culture
+steward doctor ../culture --json --check portability
+
+# Walk every culture.yaml in the workspace, score each declared agent
+# against the corpus baseline, and write per-repo feedback into
+# <target>/docs/steward/steward-suggestions.md. Diagnostic-only.
+steward doctor --scope siblings
+```
+
+`steward doctor` is read-only diagnosis. `--scope self` (default) runs the
+single-repo invariant checks against `TARGET`. `--scope siblings` walks every
+`culture.yaml` in the workspace, refreshes
+[`docs/perfect-patient.md`](docs/perfect-patient.md) from the corpus, and
+writes per-target feedback into each sibling's
+`docs/steward/steward-suggestions.md`. The repair mode (`--apply`) is on the
+roadmap but not implemented yet.
+
+See [`docs/sibling-pattern.md`](docs/sibling-pattern.md) for the contract
+`doctor` honors and [`docs/perfect-patient.md`](docs/perfect-patient.md) for
+the auto-generated corpus baseline.
+
+See [`CLAUDE.md`](CLAUDE.md) for project-shape, build/test/publish details, and
+the skills convention.
+
+## License
+
+MIT — see [`LICENSE`](LICENSE).

{steward_cli-0.3.1 → steward_cli-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "steward-cli"
-version = "0.3.1"
+version = "0.3.2"
 description = "Steward — aligns and maintains resident agents across Culture projects."
 readme = "README.md"
 license = "MIT"

{steward_cli-0.3.1 → steward_cli-0.3.2}/uv.lock

@@ -439,7 +439,7 @@ wheels = [
 
 [[package]]
 name = "steward-cli"
-version = "0.3.1"
+version = "0.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },

steward_cli-0.3.1/README.md

@@ -1,40 +0,0 @@
-# steward
-
-Steward aligns and maintains resident agents across Culture projects.
-
-## Install
-
-```bash
-pip install steward-cli
-```
-
-Or, with [uv](https://github.com/astral-sh/uv):
-
-```bash
-uv tool install steward-cli
-```
-
-## Usage
-
-```bash
-steward --version
-steward --help
-
-# Show a Culture agent's full configuration in one view
-# (CLAUDE.md + the parallel culture.yaml + .claude/skills/ index).
-# Run from inside a Steward checkout — the command finds the agent-config
-# skill script via a walk-up from the current working directory.
-steward show ../culture
-steward show ../daria
-```
-
-`steward show` is a thin wrapper over the `agent-config` skill at
-`.claude/skills/agent-config/scripts/show.sh`. The skill remains the canonical
-implementation; the CLI is the typed entry point.
-
-See [`CLAUDE.md`](CLAUDE.md) for project-shape, build/test/publish details, and
-the skills convention.
-
-## License
-
-MIT — see [`LICENSE`](LICENSE).