ortus 0.1.0__tar.gz

ortus-0.1.0/.beads/README.md

@@ -0,0 +1,81 @@
+# Beads - AI-Native Issue Tracking
+
+Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
+
+## What is Beads?
+
+Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
+
+**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+
+## Quick Start
+
+### Essential Commands
+
+```bash
+# Create new issues
+bd create "Add user authentication"
+
+# View all issues
+bd list
+
+# View issue details
+bd show <issue-id>
+
+# Update issue status
+bd update <issue-id> --status in_progress
+bd update <issue-id> --status done
+
+# Push beads to Dolt remote
+bd dolt push
+```
+
+### Working with Issues
+
+Issues in Beads are:
+- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
+- **AI-friendly**: CLI-first design works perfectly with AI coding agents
+- **Branch-aware**: Issues can follow your branch workflow
+- **Always in sync**: Auto-syncs with your commits
+
+## Why Beads?
+
+✨ **AI-Native Design**
+- Built specifically for AI-assisted development workflows
+- CLI-first interface works seamlessly with AI coding agents
+- No context switching to web UIs
+
+🚀 **Developer Focused**
+- Issues live in your repo, right next to your code
+- Works offline, syncs when you push
+- Fast, lightweight, and stays out of your way
+
+🔧 **Git Integration**
+- Automatic sync with git commits
+- Branch-aware issue tracking
+- Intelligent JSONL merge resolution
+
+## Get Started with Beads
+
+Try Beads in your own projects:
+
+```bash
+# Install Beads
+curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your repo
+bd init
+
+# Create your first issue
+bd create "Try out Beads"
+```
+
+## Learn More
+
+- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
+- **Quick Start Guide**: Run `bd quickstart`
+- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
+
+---
+
+*Beads: Issue tracking that moves at the speed of thought* ⚡

ortus-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+logs/
+
+# Human-decision report (regenerated by ortus/human.sh on each run)
+HUMAN-TODO.md
+
+# Beads / Dolt files (added by bd init)
+.dolt/
+*.db
+.beads-credential-key
+
+# Python build / venv / cache artifacts
+.venv/
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.py[cod]
+.cache/
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+
+# Node detritus that shouldn't be tracked at repo root
+node_modules/
+package-lock.json
+package.json
+

ortus-0.1.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: ortus
+Version: 0.1.0
+Summary: Global Python CLI for ortus: bd-driven Claude Code workflows
+Project-URL: Homepage, https://github.com/who/ortus
+Project-URL: Repository, https://github.com/who/ortus
+Project-URL: Issues, https://github.com/who/ortus/issues
+Author-email: who <githubwho@gmail.com>
+License: MIT
+Keywords: ai-coding,bd,beads,claude,cli,ortus
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: portalocker>=2.0.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-subprocess>=1.5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Ortus
+
+[![test](https://github.com/who/ortus/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/who/ortus/actions/workflows/test.yml)
+
+*Ortus* (Latin: "rising, origin, birth") — the point from which something springs into being.
+
+Ortus autonomously closes a backlog of bd-tracked issues using Claude Code, one fresh subprocess per task. Inspired by the Ralph Loop concept: fresh window per task, drive the queue to zero, no context drift.
+
+## Install
+
+**Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) on PATH.** Ortus is distributed via PyPI and installed by uv; we don't auto-install uv.
+
+**One-liner (recommended):**
+
+```bash
+curl -fsSL https://github.com/who/ortus/releases/latest/download/install.sh | sh
+```
+
+**Direct PyPI:**
+
+```bash
+uv tool install ortus
+ortus --version
+```
+
+**From source / pinned commit:**
+
+```bash
+uv tool install git+https://github.com/who/ortus.git
+# Pin a specific tag/branch:
+uv tool install 'git+https://github.com/who/ortus.git@v0.1.0'
+```
+
+**Troubleshooting:**
+
+| Symptom | Fix |
+|---|---|
+| `uv: command not found` | Install uv: `curl -LsSf https://astral.sh/uv/install.sh \| sh` (see [uv docs](https://docs.astral.sh/uv/getting-started/installation/)) |
+| `ortus: command not found` after install | `uv tool update-shell` then open a new shell |
+| `bd: command not found` | `brew install beads` (mac) or grab a release from https://github.com/gastownhall/beads/releases |
+
+## Quick start
+
+```bash
+# Install Ortus globally (system-wide — don't add ortus as a project dependency)
+curl -fsSL https://github.com/who/ortus/releases/latest/download/install.sh | sh
+
+# Bootstrap YOUR project
+cd your-project
+ortus init .
+
+# Verify prereqs (bd, claude, jq, hooks, sandbox)
+ortus check .
+
+# Decompose a PRD into bd issues
+ortus plan . path/to/feature.md
+
+# Or run the idea→interview→PRD→tasks flow with no PRD path
+ortus plan .
+
+# Drive the bd queue to zero — one task per fresh /goal subprocess
+ortus grind .
+
+# Bounded: stop after N tasks
+ortus grind . --tasks 5
+```
+
+**Note:** Ortus is a global CLI you install once and use everywhere. You don't clone this repository into your project — `ortus init` only adds a small set of per-project files (`.beads/`, `.claude/settings.json`, `AGENTS.md`, `.ortusrc`, `.gitignore`) to an existing directory. It is not a Python dependency.
+
+## The eight verbs
+
+| Verb | Purpose |
+|---|---|
+| `ortus init <repo>` | Bootstrap a fresh repo with bd + .claude/settings.json + AGENTS.md + .ortusrc + .gitignore |
+| `ortus check <repo>` | Verify bd/claude/jq + sandbox prereq + hook-enabled + settings shape; strictly read-only |
+| `ortus plan <repo> [<PRD>]` | Decompose a PRD into bd issues, or interview-then-PRD-then-decompose if no PRD path |
+| `ortus grind <repo>` | Drive the bd queue, one task per fresh `claude -p '/goal …'` subprocess |
+| `ortus interview <repo> [<feature-id>]` | Interactive PRD-building interview for an open feature |
+| `ortus tail <repo>` | Follow `logs/{grind,goal,ralph}-*.log` with stream-json filtering |
+| `ortus triage <repo>` | Walk the human-flagged bd queue interactively |
+| `ortus human <repo>` | Render `HUMAN-TODO.md` from bd issues flagged for a human decision |
+
+Run `ortus <verb> --help` for flags. Run `ortus --version` for the installed version.
+
+### Supported platforms
+
+| Platform | Status | Notes |
+|---|---|---|
+| Linux (Ubuntu/WSL2) | full | requires `bubblewrap` for `ortus grind` |
+| macOS | full | Seatbelt (`sandbox-exec`) is built-in |
+
+**Windows is not supported** (decision 2026-05-17). Windows users should run ortus inside **WSL2** (Windows Subsystem for Linux), where ortus runs as a normal Linux process.
+
+## Prerequisites
+
+| Tool | Why | Install |
+|---|---|---|
+| **uv** | install + run ortus | [docs.astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/) |
+| **bd** (beads) v1.0.0+ | issue tracking (backed by embedded Dolt) | `brew install beads` or [GH release](https://github.com/gastownhall/beads/releases) |
+| **claude** | the model running inside `ortus grind` | [Claude Code](https://github.com/anthropics/claude-code) |
+| **jq** | bd JSON post-processing | `brew install jq` / `apt install jq` |
+| **bwrap** (Linux) or **sandbox-exec** (Mac) | OS-level sandbox for `ortus grind` | `apt install bubblewrap` / built into macOS |
+
+Optional: **[CodeGraph](https://github.com/colbymchenry/codegraph)**. If `.codegraph/` exists in a project, `ortus grind`'s prompts use it for faster symbol/caller/callee lookups; otherwise the loop falls back to grep + Read.
+
+## Why ortus
+
+- **One install, all projects.** `uv tool install ortus` once; every repo uses the same canonical tooling. No more `copier update` chasing N repos.
+- **`bd ready` IS the queue.** No README task lists, no TodoWrite scratchpads. The queue is data.
+- **`/goal` IS the loop.** Termination is a hook decision based on observable bd state, not a sentinel grep.
+- **Sandboxed by default.** `ortus grind` refuses to launch unless bwrap/Seatbelt is available; cache directories are project-local; network is allowlist-only via `.claude/settings.json`.
+
+## Configuration
+
+Optional `<repo>/.ortusrc` (TOML) overrides `~/.ortusrc`:
+
+```toml
+prefix = "myproj"       # bd issue-id prefix
+project_type = "python" # python | typescript | go | rust | polyglot
+```
+
+Per-repo or user-wide prompt overrides live at `<repo>/.ortus/prompts/<name>.md` or `~/.ortus/prompts/<name>.md`; the bundled defaults under `src/ortus/prompts/` are the fallback (FR-025).
+
+## Session-close protocol
+
+When ending a work session, push your work:
+
+```bash
+bd close <id> --reason "..."
+git add -A && git commit -m "..."
+bd dolt push
+git push
+```
+
+Work is not done until pushed. The generated `AGENTS.md` repeats this in every project.
+
+## Development
+
+```bash
+# Local editable install
+uv pip install -e '.[dev]'
+
+# Tests
+pytest                              # unit + integration (fast)
+pytest -m smoke                     # end-to-end smoke
+pytest --slow                       # everything, including real-claude smoke
+```
+
+## License
+
+MIT

ortus-0.1.0/README.md

@@ -0,0 +1,151 @@
+# Ortus
+
+[![test](https://github.com/who/ortus/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/who/ortus/actions/workflows/test.yml)
+
+*Ortus* (Latin: "rising, origin, birth") — the point from which something springs into being.
+
+Ortus autonomously closes a backlog of bd-tracked issues using Claude Code, one fresh subprocess per task. Inspired by the Ralph Loop concept: fresh window per task, drive the queue to zero, no context drift.
+
+## Install
+
+**Requires [uv](https://docs.astral.sh/uv/getting-started/installation/) on PATH.** Ortus is distributed via PyPI and installed by uv; we don't auto-install uv.
+
+**One-liner (recommended):**
+
+```bash
+curl -fsSL https://github.com/who/ortus/releases/latest/download/install.sh | sh
+```
+
+**Direct PyPI:**
+
+```bash
+uv tool install ortus
+ortus --version
+```
+
+**From source / pinned commit:**
+
+```bash
+uv tool install git+https://github.com/who/ortus.git
+# Pin a specific tag/branch:
+uv tool install 'git+https://github.com/who/ortus.git@v0.1.0'
+```
+
+**Troubleshooting:**
+
+| Symptom | Fix |
+|---|---|
+| `uv: command not found` | Install uv: `curl -LsSf https://astral.sh/uv/install.sh \| sh` (see [uv docs](https://docs.astral.sh/uv/getting-started/installation/)) |
+| `ortus: command not found` after install | `uv tool update-shell` then open a new shell |
+| `bd: command not found` | `brew install beads` (mac) or grab a release from https://github.com/gastownhall/beads/releases |
+
+## Quick start
+
+```bash
+# Install Ortus globally (system-wide — don't add ortus as a project dependency)
+curl -fsSL https://github.com/who/ortus/releases/latest/download/install.sh | sh
+
+# Bootstrap YOUR project
+cd your-project
+ortus init .
+
+# Verify prereqs (bd, claude, jq, hooks, sandbox)
+ortus check .
+
+# Decompose a PRD into bd issues
+ortus plan . path/to/feature.md
+
+# Or run the idea→interview→PRD→tasks flow with no PRD path
+ortus plan .
+
+# Drive the bd queue to zero — one task per fresh /goal subprocess
+ortus grind .
+
+# Bounded: stop after N tasks
+ortus grind . --tasks 5
+```
+
+**Note:** Ortus is a global CLI you install once and use everywhere. You don't clone this repository into your project — `ortus init` only adds a small set of per-project files (`.beads/`, `.claude/settings.json`, `AGENTS.md`, `.ortusrc`, `.gitignore`) to an existing directory. It is not a Python dependency.
+
+## The eight verbs
+
+| Verb | Purpose |
+|---|---|
+| `ortus init <repo>` | Bootstrap a fresh repo with bd + .claude/settings.json + AGENTS.md + .ortusrc + .gitignore |
+| `ortus check <repo>` | Verify bd/claude/jq + sandbox prereq + hook-enabled + settings shape; strictly read-only |
+| `ortus plan <repo> [<PRD>]` | Decompose a PRD into bd issues, or interview-then-PRD-then-decompose if no PRD path |
+| `ortus grind <repo>` | Drive the bd queue, one task per fresh `claude -p '/goal …'` subprocess |
+| `ortus interview <repo> [<feature-id>]` | Interactive PRD-building interview for an open feature |
+| `ortus tail <repo>` | Follow `logs/{grind,goal,ralph}-*.log` with stream-json filtering |
+| `ortus triage <repo>` | Walk the human-flagged bd queue interactively |
+| `ortus human <repo>` | Render `HUMAN-TODO.md` from bd issues flagged for a human decision |
+
+Run `ortus <verb> --help` for flags. Run `ortus --version` for the installed version.
+
+### Supported platforms
+
+| Platform | Status | Notes |
+|---|---|---|
+| Linux (Ubuntu/WSL2) | full | requires `bubblewrap` for `ortus grind` |
+| macOS | full | Seatbelt (`sandbox-exec`) is built-in |
+
+**Windows is not supported** (decision 2026-05-17). Windows users should run ortus inside **WSL2** (Windows Subsystem for Linux), where ortus runs as a normal Linux process.
+
+## Prerequisites
+
+| Tool | Why | Install |
+|---|---|---|
+| **uv** | install + run ortus | [docs.astral.sh/uv](https://docs.astral.sh/uv/getting-started/installation/) |
+| **bd** (beads) v1.0.0+ | issue tracking (backed by embedded Dolt) | `brew install beads` or [GH release](https://github.com/gastownhall/beads/releases) |
+| **claude** | the model running inside `ortus grind` | [Claude Code](https://github.com/anthropics/claude-code) |
+| **jq** | bd JSON post-processing | `brew install jq` / `apt install jq` |
+| **bwrap** (Linux) or **sandbox-exec** (Mac) | OS-level sandbox for `ortus grind` | `apt install bubblewrap` / built into macOS |
+
+Optional: **[CodeGraph](https://github.com/colbymchenry/codegraph)**. If `.codegraph/` exists in a project, `ortus grind`'s prompts use it for faster symbol/caller/callee lookups; otherwise the loop falls back to grep + Read.
+
+## Why ortus
+
+- **One install, all projects.** `uv tool install ortus` once; every repo uses the same canonical tooling. No more `copier update` chasing N repos.
+- **`bd ready` IS the queue.** No README task lists, no TodoWrite scratchpads. The queue is data.
+- **`/goal` IS the loop.** Termination is a hook decision based on observable bd state, not a sentinel grep.
+- **Sandboxed by default.** `ortus grind` refuses to launch unless bwrap/Seatbelt is available; cache directories are project-local; network is allowlist-only via `.claude/settings.json`.
+
+## Configuration
+
+Optional `<repo>/.ortusrc` (TOML) overrides `~/.ortusrc`:
+
+```toml
+prefix = "myproj"       # bd issue-id prefix
+project_type = "python" # python | typescript | go | rust | polyglot
+```
+
+Per-repo or user-wide prompt overrides live at `<repo>/.ortus/prompts/<name>.md` or `~/.ortus/prompts/<name>.md`; the bundled defaults under `src/ortus/prompts/` are the fallback (FR-025).
+
+## Session-close protocol
+
+When ending a work session, push your work:
+
+```bash
+bd close <id> --reason "..."
+git add -A && git commit -m "..."
+bd dolt push
+git push
+```
+
+Work is not done until pushed. The generated `AGENTS.md` repeats this in every project.
+
+## Development
+
+```bash
+# Local editable install
+uv pip install -e '.[dev]'
+
+# Tests
+pytest                              # unit + integration (fast)
+pytest -m smoke                     # end-to-end smoke
+pytest --slow                       # everything, including real-claude smoke
+```
+
+## License
+
+MIT

ortus-0.1.0/pyproject.toml

@@ -0,0 +1,81 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ortus"
+version = "0.1.0"
+description = "Global Python CLI for ortus: bd-driven Claude Code workflows"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "who", email = "githubwho@gmail.com" }]
+keywords = ["claude", "beads", "bd", "cli", "ortus", "ai-coding"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "jinja2>=3.1.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+    "portalocker>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "pytest-subprocess>=1.5.0",
+    "build>=1.2.0",
+]
+
+[project.scripts]
+ortus = "ortus.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/who/ortus"
+Repository = "https://github.com/who/ortus"
+Issues = "https://github.com/who/ortus/issues"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/ortus",
+    "README.md",
+    "pyproject.toml",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ortus"]
+# hatchling skips dotfiles by default; force-include only the dot-prefixed
+# leaf files (the .claude/ subtree is picked up by `packages` already since
+# it contains a .jinja file, so re-listing it duplicates entries).
+[tool.hatch.build.targets.wheel.force-include]
+"src/ortus/templates/.ortusrc.jinja" = "ortus/templates/.ortusrc.jinja"
+"src/ortus/templates/.gitignore.jinja" = "ortus/templates/.gitignore.jinja"
+
+[tool.hatch.build.targets.sdist.force-include]
+"src/ortus/templates/.ortusrc.jinja" = "src/ortus/templates/.ortusrc.jinja"
+"src/ortus/templates/.gitignore.jinja" = "src/ortus/templates/.gitignore.jinja"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra --strict-markers"
+markers = [
+    "integration: tests that shell out to real external binaries (bd, claude, etc.)",
+    "regression: regression tests guarding against specific past bugs (e.g., ortus-6q8v stream-leak)",
+    "smoke: end-to-end smoke tests against seeded fixtures + canned claude responses",
+    "slow: tests that exceed ~5s (gated behind --slow in CI; on by default locally)",
+]

ortus-0.1.0/src/ortus/__init__.py

@@ -0,0 +1,3 @@
+"""ortus: global Python CLI for bd-driven Claude Code workflows."""
+
+__version__ = "0.1.0"

ortus-0.1.0/src/ortus/__main__.py

@@ -0,0 +1,11 @@
+"""Entry point for `python -m ortus` and the `ortus` console script."""
+
+from ortus.cli import app
+
+
+def main() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    main()

ortus-0.1.0/src/ortus/cli.py

@@ -0,0 +1,60 @@
+"""Top-level typer app + 8-verb registration (FR-001, FR-002, FR-004, FR-005)."""
+
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
+import typer
+
+from ortus.commands.check import check
+from ortus.commands.grind import grind
+from ortus.commands.human import human
+from ortus.commands.init import init
+from ortus.commands.interview import interview
+from ortus.commands.plan import plan
+from ortus.commands.tail import tail
+from ortus.commands.triage import triage
+
+app = typer.Typer(
+    name="ortus",
+    help="Global CLI for bd-driven Claude Code workflows.",
+    no_args_is_help=True,
+    add_completion=False,
+)
+
+
+def _resolve_version() -> str:
+    try:
+        return _pkg_version("ortus")
+    except PackageNotFoundError:
+        from ortus import __version__
+
+        return __version__
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"ortus {_resolve_version()}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        callback=_version_callback,
+        is_eager=True,
+        help="Show ortus version and exit.",
+    ),
+) -> None:
+    """ortus: global CLI for bd-driven Claude Code workflows."""
+
+
+# FR-002: exactly 8 verbs. Order here drives --help listing order.
+app.command(name="init", help="Bootstrap a fresh repo (bd + .claude + AGENTS.md).")(init)
+app.command(name="plan", help="Decompose a PRD (or freeform idea) into bd issues.")(plan)
+app.command(name="grind", help="Drive the bd queue via a subprocess-per-task claude /goal loop.")(grind)
+app.command(name="interview", help="Interactive PRD-building interview.")(interview)
+app.command(name="tail", help="Tail orchestrator log files (grind-*, goal-*, ralph-*).")(tail)
+app.command(name="triage", help="Triage open bd issues interactively.")(triage)
+app.command(name="human", help="Emit HUMAN-TODO.md for items needing a human decision.")(human)
+app.command(name="check", help="Verify bd/claude/sandbox prereqs.")(check)

ortus-0.1.0/src/ortus/commands/_stub.py

@@ -0,0 +1,17 @@
+"""Shared 'not implemented' helper for Phase 1 stub verbs."""
+
+from __future__ import annotations
+
+import typer
+from rich.console import Console
+
+_err = Console(stderr=True)
+
+
+def not_implemented(verb: str, phase: str) -> None:
+    """Print a clear unimplemented-stub message and exit 2."""
+    _err.print(
+        f"[yellow]ortus {verb}:[/yellow] not implemented in this phase "
+        f"(lands in {phase})."
+    )
+    raise typer.Exit(code=2)