feat!: v0.4.0 remove deprecated --profile flag (#6)

* refactor(v0.4.0): migrate tests to install_selection

Switch the five test files that used init.run(profile_id=...) as a
fixture setup to call install_selection(target, Selection(...)) instead.
The legacy init.py shim is being removed in v0.4.0; this commit keeps
the suite green so the deletion in the next commit can land cleanly.

- test_init.py: rewrite as install_selection tests, drop the legacy
  --profile path coverage (test_legacy_profile_*, _unknown_profile_,
  _rejects_unsafe_profile_paths) and the contract-docs test (the
  v0.3.0 mapping for --profile generic is harnesses=[], which does
  not surface .solo-mise/generic/*).
- test_doctor.py: drop init_mod import; install_selection now writes
  config.json so the openclaw-checks tests need 'openclaw' in the
  selection's harnesses.
- test_ingest.py, test_handoff.py: swap init.run -> install_selection.
- test_gitignore.py: pull GITIGNORE_BEGIN/END from install.py; drop
  the update_gitignore=False tests (install_selection always writes
  the managed block).

109 tests pass.

* test(selection): drop legacy profile_to_selection coverage

The 7 test_profile_to_selection_* cases exercise a function being removed
in the next commit. Drop them and the now-unused import. Companion to
cc26412 which migrated the other five test files off init.run.

* feat(cli)!: remove deprecated --profile flag and supporting code

The --profile flag was deprecated in v0.3.0 with a stderr warning showing
the new --depth/--harnesses equivalent. v0.4.0 removes it along with the
dead code paths it kept alive:

- cli.py: drop the --profile argparse argument and the deprecation shim
  that translated profile ids into Selections.
- selection.py: drop _PROFILE_MAP and profile_to_selection.
- templates.py: drop load_profile (depth/harness/include manifests use
  _load_layered, which stays).
- init.py: delete the module. install.install_selection is the only
  install path now.
- templates/profiles/: delete the six legacy profile manifests.
- prompt.py: drop the "(or --profile)" hint in the non-interactive error.

BREAKING CHANGE: `solo-mise init --profile <x>` now errors out as an
unrecognized argument. Use --depth + --harnesses (see v0.3.0 CHANGELOG
migration table).

* release: prepare v0.4.0

- Bump version to 0.4.0 in pyproject.toml and src/solo_mise/__init__.py.
- CHANGELOG: document the --profile removal and link refs.
- CI: drop the two legacy-profile install-from-source matrix entries
  (the flag no longer exists, so the jobs would just argparse-fail).

Author: solomonneas

.github/workflows/ci.yml

@@ -66,10 +66,6 @@ jobs:
             flags: "--depth workspace --harnesses none"
           - name: "repo+claude+publisher"
             flags: "--depth repo --harnesses claude --include publisher"
-          - name: "legacy-workspace"
-            flags: "--profile workspace"
-          - name: "legacy-openclaw"
-            flags: "--profile openclaw"
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5

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.4.0] - 2026-05-17
+
+### Removed
+- `solo-mise init --profile <x>` flag and all supporting code paths. The flag has been deprecated since v0.3.0 with a stderr warning showing the new equivalent. Anyone still using it must switch to `--depth ... --harnesses ...` (see the v0.3.0 migration table below).
+- Internal: `src/solo_mise/init.py` module (superseded by `install.install_selection`).
+- Internal: `templates/profiles/` directory and the six legacy profile manifests.
+- Internal: `templates.load_profile` and `selection.profile_to_selection`.
+
+### Migration
+
+Same as v0.3.0. If you somehow have v0.2.0-era scripts still using `--profile`, see the table in the v0.3.0 section below.
+
 ## [0.3.0] - 2026-05-16
 
 ### Added
@@ -91,7 +103,8 @@ Initial release.
 - OpenClaw adapter fragments and harness-aware doctor checks.
 - Experimental Hermes adapter fragments.
 
-[Unreleased]: https://github.com/solomonneas/solo-mise/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/solomonneas/solo-mise/compare/v0.4.0...HEAD
+[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
 [0.1.0]: https://github.com/solomonneas/solo-mise/releases/tag/v0.1.0

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "solo-mise"
-version = "0.3.0"
+version = "0.4.0"
 description = "Mise en place for agent memory. Installable starter kit for a harness-agnostic agent workspace."
 readme = "README.md"
 requires-python = ">=3.10"

src/solo_mise/__init__.py

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

src/solo_mise/cli.py

@@ -21,20 +21,8 @@ def _build_parser() -> argparse.ArgumentParser:
     sub.required = True
 
     # init
-    p_init = sub.add_parser("init", help="Materialize a profile into a target directory.")
+    p_init = sub.add_parser("init", help="Materialize a selection into a target directory.")
     p_init.add_argument("--target", "-t", type=Path, default=Path("."), help="Where to install.")
-    p_init.add_argument(
-        "--profile",
-        "-p",
-        default=None,
-        choices=["repo", "workspace", "openclaw", "hermes", "generic", "publisher"],
-        help="(Deprecated) Profile to install. Use --depth/--harnesses instead.",
-    )
-    p_init.add_argument(
-        "--harness",
-        help="Override the memory-owner label rendered into bootstrap files. "
-        "Defaults to the profile's memory_owner_default.",
-    )
     p_init.add_argument("--force", action="store_true", help="Overwrite existing files.")
     p_init.add_argument(
         "--allow-home",
@@ -54,7 +42,7 @@ def _build_parser() -> argparse.ArgumentParser:
         choices=["repo", "workspace"],
         default=None,
         help="Install depth: 'repo' (minimal) or 'workspace' (full home). "
-             "Required unless --profile is used.",
+             "Omit for an interactive prompt.",
     )
     p_init.add_argument(
         "--harnesses",
@@ -176,30 +164,7 @@ def main(argv=None) -> int:
                 allow_home=getattr(args, "allow_home", False),
             )
 
-        # Legacy --profile path: translate to a Selection, warn, install.
-        if args.profile:
-            from .selection import profile_to_selection
-            from .install import install_selection
-            sel = profile_to_selection(args.profile)
-            equivalent = f"--depth {sel.depth} --harnesses {','.join(sel.harnesses) or 'none'}"
-            if sel.owner != "this-repo" and sel.owner in sel.harnesses:
-                equivalent += f" --owner {sel.owner}"
-            for inc in sel.includes:
-                equivalent += f" --include {inc}"
-            print(
-                f"warning: --profile is deprecated. The v0.3.0+ equivalent is "
-                f"`{equivalent}`. --profile will be removed in v0.4.0.",
-                file=sys.stderr,
-            )
-            return install_selection(
-                target=args.target,
-                selection=sel,
-                force=getattr(args, "force", False),
-                dry_run=getattr(args, "dry_run", False),
-                allow_home=getattr(args, "allow_home", False),
-            )
-
-        # No flags and no --profile: interactive prompt.
+        # No selection flags: interactive prompt.
         from .prompt import NonInteractiveError
         from .install import install_selection
         try:

src/solo_mise/init.py

@@ -46,7 +46,7 @@ def prompt_for_selection() -> Selection:
     if not sys.stdin.isatty():
         raise NonInteractiveError(
             "solo-mise init needs a TTY for the interactive prompt. "
-            "Pass --depth and --harnesses (or --profile) for scripting."
+            "Pass --depth and --harnesses for scripting."
         )
 
     selected_harnesses = _toggle_prompt(

src/solo_mise/prompt.py

@@ -64,29 +64,3 @@ def resolve_owner(harnesses: List[str], override: Optional[str] = None) -> str:
         if candidate in harnesses:
             return candidate
     return "this-repo"
-
-
-_PROFILE_MAP = {
-    "repo":      Selection(depth="repo",      harnesses=["claude"],             owner="claude",    includes=[]),
-    "workspace": Selection(depth="workspace", harnesses=["claude"],             owner="claude",    includes=[]),
-    "openclaw":  Selection(depth="workspace", harnesses=["claude", "openclaw"], owner="openclaw",  includes=[]),
-    "hermes":    Selection(depth="workspace", harnesses=["claude", "hermes"],   owner="hermes",    includes=[]),
-    "generic":   Selection(depth="workspace", harnesses=[],                     owner="this-repo", includes=[]),
-    "publisher": Selection(depth="repo",      harnesses=["claude"],             owner="claude",    includes=["publisher"]),
-}
-
-
-def profile_to_selection(profile_id: str) -> Selection:
-    """Translate a legacy --profile id into a Selection. Used by the deprecation shim."""
-    if profile_id not in _PROFILE_MAP:
-        raise ValueError(
-            f"unknown profile: {profile_id!r} (valid: {sorted(_PROFILE_MAP)})"
-        )
-    sel = _PROFILE_MAP[profile_id]
-    # Return a copy to keep callers from mutating the map.
-    return Selection(
-        depth=sel.depth,
-        harnesses=list(sel.harnesses),
-        owner=sel.owner,
-        includes=list(sel.includes),
-    )