Merge pull request #7 from solomonneas/feat/brigade-foundation

Rebrand solo-mise to Brigade with station registry

Author: solomonneas

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-05-24
+
+### Changed
+- Renamed the project to **Brigade**. The PyPI distribution is now `brigade-cli` and the command is `brigade`. The workspace config directory is now `.brigade`, with a `.solo-mise` read fallback so older installs keep working.
+
+### Added
+- Built-in station registry that drives the doctor checks.
+- `brigade status` command, alongside `brigade init` and `brigade doctor`, reporting over the station registry.
+
+### Deprecated
+- The `solo-mise` command is kept as a deprecated alias for `brigade`.
+
 ## [0.4.0] - 2026-05-17
 
 ### Breaking
@@ -103,7 +115,8 @@ Initial release.
 - OpenClaw adapter fragments and harness-aware doctor checks.
 - Experimental Hermes adapter fragments.
 
-[Unreleased]: https://github.com/solomonneas/solo-mise/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/solomonneas/solo-mise/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/solomonneas/solo-mise/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/solomonneas/solo-mise/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/solomonneas/solo-mise/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/solomonneas/solo-mise/compare/v0.1.0...v0.2.0

README.md

@@ -55,7 +55,7 @@ The cookbook explains the why. This package gives you the kitchen.
 ## Install
 
 ```bash
-pipx install solo-mise
+pipx install brigade-cli
 ```
 
 Or, to track `main`:
@@ -64,22 +64,26 @@ Or, to track `main`:
 pipx install git+https://github.com/solomonneas/solo-mise
 ```
 
+The workspace config directory is `.brigade` (older `.solo-mise` installs are still read), and the `solo-mise` command is a deprecated alias for `brigade`.
+
 ## Quick path
 
-Run `solo-mise init` with no flags for the interactive picker:
+Run `brigade init` with no flags for the interactive picker:
 
 ```bash
-solo-mise init --target ~/agent-kitchen
+brigade init --target ~/agent-kitchen
 ```
 
 For CI or scripts, pass flags directly:
 
 ```bash
-solo-mise init --target ~/agent-kitchen --depth workspace --harnesses claude,codex,openclaw
-solo-mise init --target ./repo --depth repo --harnesses codex
-solo-mise init --target ./repo --harnesses none           # generic install
+brigade init --target ~/agent-kitchen --depth workspace --harnesses claude,codex,openclaw
+brigade init --target ./repo --depth repo --harnesses codex
+brigade init --target ./repo --harnesses none           # generic install
 ```
 
+Once installed, `brigade doctor` verifies the wiring and `brigade status` reports over the station registry.
+
 ## Two axes: depth + harnesses
 
 solo-mise installs material on two independent axes:
@@ -117,14 +121,14 @@ Four common combos:
 
 The canonical memory owner is picked automatically by priority (`openclaw > hermes > claude > codex > this-repo`). Override with `--owner`.
 
-Re-running `solo-mise init` against an existing target is safe. It refuses to overwrite tracked files without `--force`, and the `.gitignore` block it manages is replaced between its markers without touching the rest of your file.
+Re-running `brigade init` against an existing target is safe. It refuses to overwrite tracked files without `--force`, and the `.gitignore` block it manages is replaced between its markers without touching the rest of your file.
 
 See [QUICKSTART.md](QUICKSTART.md) for setup, verification, and the ingest flow.
 
 ### What a green doctor looks like
 
 ```text
-solo-mise doctor: target /home/you/agent-kitchen (generic)
+brigade doctor: target /home/you/agent-kitchen (generic)
   [ok]   bootstrap: AGENTS.md              /home/you/agent-kitchen/AGENTS.md
   [ok]   bootstrap: CLAUDE.md              /home/you/agent-kitchen/CLAUDE.md
   [ok]   bootstrap: MEMORY.md              /home/you/agent-kitchen/MEMORY.md
@@ -160,7 +164,7 @@ Claude Code              Codex
      \                   /
       \                 /
        v               v
-      solo-mise ingest
+      brigade ingest
               |
               v
   memory/cards/*.md, TOOLS.md, USER.md,

pyproject.toml

@@ -3,8 +3,8 @@ requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "solo-mise"
-version = "0.4.0"
+name = "brigade-cli"
+version = "0.5.0"
 description = "Mise en place for agent memory. Installable starter kit for a harness-agnostic agent workspace."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -30,13 +30,14 @@ Cookbook = "https://github.com/solomonneas/solos-cookbook"
 Issues = "https://github.com/solomonneas/solo-mise/issues"
 
 [project.scripts]
-solo-mise = "solo_mise.cli:main"
+brigade = "brigade.cli:main"
+solo-mise = "brigade.cli:main_deprecated"
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
 [tool.setuptools.package-data]
-solo_mise = ["py.typed", "templates/**/*"]
+brigade = ["py.typed", "templates/**/*"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

src/solo_mise/__init__.py src/brigade/__init__.pysrc/solo_mise/__init__.py renamed to src/brigade/__init__.py

@@ -1,3 +1,3 @@
 """Solomon's Mise en Place: installable starter kit for an agent kitchen."""
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"

src/solo_mise/__main__.py src/brigade/__main__.pysrc/solo_mise/__main__.py renamed to src/brigade/__main__.py

@@ -1,4 +1,4 @@
-"""Enable `python -m solo_mise`."""
+"""Enable `python -m brigade`."""
 from .cli import main
 
 if __name__ == "__main__":

src/solo_mise/cli.py src/brigade/cli.pysrc/solo_mise/cli.py renamed to src/brigade/cli.py

@@ -1,4 +1,4 @@
-"""solo-mise command-line entrypoint."""
+"""brigade command-line entrypoint."""
 from __future__ import annotations
 
 import argparse
@@ -11,11 +11,11 @@
 
 def _build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
-        prog="solo-mise",
-        description="Solomon's Mise en Place: installable agent kitchen starter kit.",
+        prog="brigade",
+        description="Brigade: run your agent brigade. Operator-system CLI for agent workspaces.",
     )
     parser.add_argument(
-        "--version", action="version", version=f"solo-mise {__version__}"
+        "--version", action="version", version=f"brigade {__version__}"
     )
     sub = parser.add_subparsers(dest="command", metavar="<command>")
     sub.required = True
@@ -72,13 +72,17 @@ def _build_parser() -> argparse.ArgumentParser:
         default="generic",
     )
 
+    # status
+    p_status = sub.add_parser("status", help="Show which stations are present and healthy.")
+    p_status.add_argument("--target", "-t", type=Path, default=Path("."))
+
     # scrub
     p_scrub = sub.add_parser("scrub", help="Run content-guard against a target.")
     p_scrub.add_argument("--target", "-t", type=Path, default=Path("."))
     p_scrub.add_argument(
         "--policy",
         default="public-repo",
-        help="Policy file name (looks under .solo-mise/policies, then content-guard/policies) or path.",
+        help="Policy file name (looks under .brigade/policies, then content-guard/policies) or path.",
     )
     p_scrub.add_argument("--dry-run", action="store_true")
 
@@ -183,6 +187,10 @@ def main(argv=None) -> int:
         from . import doctor as doctor_mod
 
         return doctor_mod.run(target=args.target, harness=args.harness)
+    if cmd == "status":
+        from . import status as status_mod
+
+        return status_mod.run(target=args.target)
     if cmd == "scrub":
         from . import scrub as scrub_mod
 
@@ -215,7 +223,7 @@ def main(argv=None) -> int:
 
         existing = load_config(args.target)
         if existing is None:
-            print("error: no .solo-mise/config.json in target. Run `solo-mise init` first.", file=sys.stderr)
+            print("error: no .brigade/config.json in target. Run `brigade init` first.", file=sys.stderr)
             return 2
 
         depth = args.depth or existing.selection.depth
@@ -238,5 +246,13 @@ def main(argv=None) -> int:
     return 2
 
 
+def main_deprecated(argv=None) -> int:
+    print(
+        "warning: the 'solo-mise' command is deprecated; use 'brigade' instead.",
+        file=sys.stderr,
+    )
+    return main(argv)
+
+
 if __name__ == "__main__":  # pragma: no cover
     sys.exit(main())

src/solo_mise/config.py src/brigade/config.pysrc/solo_mise/config.py renamed to src/brigade/config.py

@@ -1,4 +1,4 @@
-"""Read/write .solo-mise/config.json - the per-target source of truth."""
+"""Read/write .brigade/config.json - the per-target source of truth."""
 from __future__ import annotations
 
 import json
@@ -9,7 +9,9 @@
 from .selection import Selection
 
 
-CONFIG_REL_PATH = ".solo-mise/config.json"
+WORKSPACE_DIRNAME = ".brigade"
+LEGACY_WORKSPACE_DIRNAMES = (".solo-mise",)
+CONFIG_REL_PATH = f"{WORKSPACE_DIRNAME}/config.json"
 SUPPORTED_VERSIONS = (1,)
 
 
@@ -40,7 +42,13 @@ def write_config(target: Path, cfg: Config) -> None:
 def load_config(target: Path) -> Optional[Config]:
     path = config_path(target)
     if not path.is_file():
-        return None
+        for legacy in LEGACY_WORKSPACE_DIRNAMES:
+            legacy_path = target / legacy / "config.json"
+            if legacy_path.is_file():
+                path = legacy_path
+                break
+        else:
+            return None
     data = json.loads(path.read_text())
     version = data.get("version")
     if version not in SUPPORTED_VERSIONS:

src/solo_mise/doctor.py src/brigade/doctor.pysrc/solo_mise/doctor.py renamed to src/brigade/doctor.py

@@ -1,4 +1,4 @@
-"""`solo-mise doctor` — verify a target workspace is wired correctly."""
+"""`brigade doctor` - verify a target workspace is wired correctly."""
 from __future__ import annotations
 
 import json
@@ -15,56 +15,70 @@
 FAIL = "FAIL"
 MANUAL = "MANUAL"
 
+from .station import DoctorContext
 
-def run(target: Path, harness: str = "generic") -> int:
-    target = target.expanduser().resolve()
-    print(f"solo-mise doctor: target {target}")
 
+def build_context(target: Path, harness: str = "generic") -> DoctorContext:
+    target = target.expanduser().resolve()
     from .config import load_config
 
-    cfg = None
+    sel = None
     try:
         cfg = load_config(target)
-    except (ValueError, json.JSONDecodeError) as exc:
-        print(f"  [fail] config: {exc}")
-
+    except (ValueError, json.JSONDecodeError):
+        cfg = None
     if cfg is not None:
         sel = cfg.selection
+        harnesses = list(sel.harnesses)
+    elif harness in ("openclaw", "hermes"):
+        harnesses = ["claude", harness]
+    else:
+        harnesses = ["claude"]
+    return DoctorContext(target=target, selection=sel, harnesses=harnesses)
+
+
+def core_station_checks(ctx: DoctorContext) -> List[CheckResult]:
+    checks: List[CheckResult] = []
+    checks.extend(_check_workspace_files(ctx.target))
+    if "openclaw" in ctx.harnesses:
+        checks.extend(_check_openclaw())
+    if "hermes" in ctx.harnesses:
+        checks.extend(_check_hermes(ctx.target))
+    checks.extend(_check_orphan_inboxes(ctx.target, ctx.harnesses))
+    return checks
+
+
+def memory_station_checks(ctx: DoctorContext) -> List[CheckResult]:
+    checks: List[CheckResult] = []
+    checks.extend(_check_handoff_inboxes(ctx.target, ctx.selection, ctx.harnesses))
+    checks.extend(_check_memory_care(ctx.target))
+    return checks
+
+
+def guard_station_checks(ctx: DoctorContext) -> List[CheckResult]:
+    return _check_publish_gate(ctx.target)
+
+
+def run(target: Path, harness: str = "generic") -> int:
+    from .registry import all_stations
+
+    ctx = build_context(target, harness)
+    print(f"brigade doctor: target {ctx.target}")
+    if ctx.selection is not None:
+        sel = ctx.selection
         print(
             f"  harnesses: {', '.join(sel.harnesses) or '(none)'} "
             f"(owner={sel.owner}, depth={sel.depth})"
         )
-        selected_harnesses = list(sel.harnesses)
     else:
-        # Legacy fall-through: no config.json present.
-        sel = None
-        if harness in ("openclaw", "hermes"):
-            print(
-                f"  harnesses: (legacy target, no .solo-mise/config.json; "
-                f"--harness={harness} so assuming claude + {harness})"
-            )
-            selected_harnesses = ["claude", harness]
-        else:
-            print(
-                "  harnesses: (legacy target, no .solo-mise/config.json; "
-                "assuming claude)"
-            )
-            selected_harnesses = ["claude"]
+        print(
+            f"  harnesses: (legacy target, no config; assuming {', '.join(ctx.harnesses)})"
+        )
 
     checks: List[CheckResult] = []
-    checks.extend(_check_workspace_files(target))
-    checks.extend(_check_handoff_inboxes(target, sel, selected_harnesses))
-    checks.extend(_check_memory_care(target))
-    checks.extend(_check_publish_gate(target))
-
-    if "openclaw" in selected_harnesses:
-        checks.extend(_check_openclaw())
-    if "hermes" in selected_harnesses:
-        checks.extend(_check_hermes(target))
-
-    # Orphan-inbox warnings.
-    checks.extend(_check_orphan_inboxes(target, selected_harnesses))
-
+    for station in all_stations():
+        if station.doctor is not None:
+            checks.extend(station.doctor(ctx))
     return _report(checks)
 
 
@@ -238,7 +252,7 @@ def _check_publish_gate(target: Path) -> List[CheckResult]:
 
 
 def _check_openclaw() -> List[CheckResult]:
-    """Inspect ~/.openclaw/openclaw.json for the wiring solo-mise expects."""
+    """Inspect ~/.openclaw/openclaw.json for the wiring brigade expects."""
     results: List[CheckResult] = []
     config = Path.home() / ".openclaw" / "openclaw.json"
     if not config.is_file():
@@ -339,7 +353,7 @@ def _format_schedule(schedule) -> str:
 
 def _check_hermes(target: Path) -> List[CheckResult]:
     results: List[CheckResult] = []
-    fragments_dir = target / ".solo-mise" / "hermes"
+    fragments_dir = target / ".brigade" / "hermes"
     expected = [
         "workspace.harness.json",
         "memory-handoff.harness.json",
@@ -350,7 +364,7 @@ def _check_hermes(target: Path) -> List[CheckResult]:
         if path.is_file():
             results.append((OK, f"hermes: {name}", str(path)))
         else:
-            results.append((WARN, f"hermes: {name}", f"missing at {path}; run `solo-mise hermes-fragments`"))
+            results.append((WARN, f"hermes: {name}", f"missing at {path}; run `brigade hermes-fragments`"))
     results.append(
         (MANUAL, "hermes: install validation", "Hermes adapter is experimental; validate against your install")
     )