roadmodel 0.2.44__tar.gz → 0.2.45__tar.gz

{roadmodel-0.2.44 → roadmodel-0.2.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: roadmodel
-Version: 0.2.44
+Version: 0.2.45
 Summary: BYO-key CLI that recommends the right AI model, platform, and settings for a prompt.
 Project-URL: Homepage, https://roadmodel.ai
 Project-URL: Repository, https://github.com/nathanramoscfa/roadmodel
@@ -323,7 +323,7 @@ What the loop guarantees, independent of the project:
   and a step that touches a deployed surface is done at post-deploy
   verification, not at merge.
 
-Setup is once per machine (`/roadmodel-update` keeps every project's
+Setup is once per machine (`/roadmodel-upgrade` keeps every project's
 copy current after that); the commands then work in any project.
 Step-by-step: [docs/planning-workflow.md](docs/planning-workflow.md).
 
@@ -360,15 +360,15 @@ pip install -U roadmodel
   **then** `roadmodel export-kit . --force` to refresh it. The `/roadmap-project`
   and `/roadmap-phase` commands do both as their Step 0.
 
-### Every project on a machine — `/roadmodel-update`
+### Every project on a machine — `/roadmodel-upgrade`
 
 Projects that each carry roadmodel in their **own** conda env or venv would
 otherwise be upgraded one at a time. Instead, from any Claude Code chat:
 
 ```
-/roadmodel-update                       # every registered project
-/roadmodel-update ~/code/app-one …      # register these dirs, then run
-/roadmodel-update --install-schedule    # once: also run daily, unattended
+/roadmodel-upgrade                      # every registered project
+/roadmodel-upgrade ~/code/app-one …     # register these dirs, then run
+/roadmodel-upgrade --install-schedule   # once: also run daily, unattended
 ```
 
 The command fetches [`scripts/update_projects.py`](scripts/update_projects.py)
@@ -446,14 +446,14 @@ hand; the `export-kit` command above avoids that entirely.
 `docs/claude-commands/` — `/roadmap-project`, `/roadmap-phase N`,
 `/roadmap-step P M` (executes a step), `/roadmap-refresh` (bookkeeping
 only: marks shipped steps and re-selects upcoming Settings, runs
-nothing), `/roadmodel-update` — see
+nothing), `/roadmodel-upgrade` — see
 [The planning workflow](#the-planning-workflow) above for the loop and
 [docs/planning-workflow.md](docs/planning-workflow.md) for setup and
 per-command detail. The same five are generated for **Gemini CLI**
 (`~/.gemini/commands/*.toml`), **Codex** and **Cursor** (one
 `~/.agents/skills/*/SKILL.md` both read; `$roadmap-step` in Codex,
 `/roadmap-step` in Cursor), and **OpenCode**
-(`~/.config/opencode/commands/*.md`), installed by `/roadmodel-update`
+(`~/.config/opencode/commands/*.md`), installed by `/roadmodel-upgrade`
 wherever those tools are present.
 
 Either way the in-editor AI runs the algorithm itself rather than calling
@@ -582,7 +582,7 @@ provider goes down, or a task suits a different model?
 (instructions, memory, skills, slash commands, MCP servers, model, effort,
 permissions) across Claude, Codex, Gemini and open-source clients in any
 direction, and carries one parameterised prompt that makes the target agent
-sync itself. `roadmodel-update` keeps the roadmap commands, the roadmodel MCP
+sync itself. `roadmodel-upgrade` keeps the roadmap commands, the roadmodel MCP
 server and the reasoning-effort default in parity automatically.
 
 ## Subcommands

{roadmodel-0.2.44 → roadmodel-0.2.45}/README.md

@@ -73,7 +73,7 @@ What the loop guarantees, independent of the project:
   and a step that touches a deployed surface is done at post-deploy
   verification, not at merge.
 
-Setup is once per machine (`/roadmodel-update` keeps every project's
+Setup is once per machine (`/roadmodel-upgrade` keeps every project's
 copy current after that); the commands then work in any project.
 Step-by-step: [docs/planning-workflow.md](docs/planning-workflow.md).
 
@@ -110,15 +110,15 @@ pip install -U roadmodel
   **then** `roadmodel export-kit . --force` to refresh it. The `/roadmap-project`
   and `/roadmap-phase` commands do both as their Step 0.
 
-### Every project on a machine — `/roadmodel-update`
+### Every project on a machine — `/roadmodel-upgrade`
 
 Projects that each carry roadmodel in their **own** conda env or venv would
 otherwise be upgraded one at a time. Instead, from any Claude Code chat:
 
 ```
-/roadmodel-update                       # every registered project
-/roadmodel-update ~/code/app-one …      # register these dirs, then run
-/roadmodel-update --install-schedule    # once: also run daily, unattended
+/roadmodel-upgrade                      # every registered project
+/roadmodel-upgrade ~/code/app-one …     # register these dirs, then run
+/roadmodel-upgrade --install-schedule   # once: also run daily, unattended
 ```
 
 The command fetches [`scripts/update_projects.py`](scripts/update_projects.py)
@@ -196,14 +196,14 @@ hand; the `export-kit` command above avoids that entirely.
 `docs/claude-commands/` — `/roadmap-project`, `/roadmap-phase N`,
 `/roadmap-step P M` (executes a step), `/roadmap-refresh` (bookkeeping
 only: marks shipped steps and re-selects upcoming Settings, runs
-nothing), `/roadmodel-update` — see
+nothing), `/roadmodel-upgrade` — see
 [The planning workflow](#the-planning-workflow) above for the loop and
 [docs/planning-workflow.md](docs/planning-workflow.md) for setup and
 per-command detail. The same five are generated for **Gemini CLI**
 (`~/.gemini/commands/*.toml`), **Codex** and **Cursor** (one
 `~/.agents/skills/*/SKILL.md` both read; `$roadmap-step` in Codex,
 `/roadmap-step` in Cursor), and **OpenCode**
-(`~/.config/opencode/commands/*.md`), installed by `/roadmodel-update`
+(`~/.config/opencode/commands/*.md`), installed by `/roadmodel-upgrade`
 wherever those tools are present.
 
 Either way the in-editor AI runs the algorithm itself rather than calling
@@ -332,7 +332,7 @@ provider goes down, or a task suits a different model?
 (instructions, memory, skills, slash commands, MCP servers, model, effort,
 permissions) across Claude, Codex, Gemini and open-source clients in any
 direction, and carries one parameterised prompt that makes the target agent
-sync itself. `roadmodel-update` keeps the roadmap commands, the roadmodel MCP
+sync itself. `roadmodel-upgrade` keeps the roadmap commands, the roadmodel MCP
 server and the reasoning-effort default in parity automatically.
 
 ## Subcommands

{roadmodel-0.2.44 → roadmodel-0.2.45}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "roadmodel"
-version = "0.2.44"
+version = "0.2.45"
 description = "BYO-key CLI that recommends the right AI model, platform, and settings for a prompt."
 readme = "README.md"
 requires-python = ">=3.11"

{roadmodel-0.2.44 → roadmodel-0.2.45}/scripts/update_projects.py

@@ -56,8 +56,12 @@ COMMANDS = (
     "roadmap-phase",
     "roadmap-step",
     "roadmap-refresh",
-    "roadmodel-update",
+    "roadmodel-upgrade",
 )
+# Commands this updater once installed under a name it no longer uses. Every
+# run removes its own copies of them for every agent; a user's own command of
+# the same name is left alone.
+RETIRED_COMMANDS = ("roadmodel-update",)  # renamed roadmodel-upgrade in 0.2.45
 CONFIG_DIR = Path.home() / ".config" / "roadmodel"
 DEFAULT_PROJECTS_FILE = CONFIG_DIR / "projects.txt"
 CLAUDE_DIR = Path.home() / ".claude"
@@ -789,7 +793,7 @@ def _sync_antigravity_trust(projects: list[Path], dry_run: bool) -> list[str]:
     ``trustedWorkspaces`` in its own settings file — NOT in the legacy CLI's
     ``trustedFolders.json``, which it never reads. A project missing from this
     list is one the operator has to approve by hand on first open, which is
-    exactly the friction `roadmodel-update` exists to remove when a machine
+    exactly the friction `roadmodel-upgrade` exists to remove when a machine
     carries seven or eight active projects."""
     if not projects:
         return []
@@ -956,6 +960,8 @@ def sync_agent_runtime(
 # --------------------------------------------------------------------------
 
 AGENTS_MEMORY_REL = Path(".agents") / "memory.md"
+# Keeps the updater's old name: an existing memory file is overwritten only
+# when it starts with this exact line.
 _MEMORY_HEADER = "<!-- generated by roadmodel-update from Claude Code auto-memory -->"
 # A whole memory directory can be 400 KB (~100k tokens) — a context bomb for an
 # agent that reads the file at session start, and most of it is the long tail.
@@ -1004,7 +1010,7 @@ def export_claude_memory(project: Path) -> Optional[str]:
         "",
         "Durable facts about this project, carried over from Claude Code's",
         "auto-memory so every agent starts from the same knowledge. Local only:",
-        "this file is git-excluded and is regenerated by `roadmodel-update`.",
+        "this file is git-excluded and is regenerated by `roadmodel-upgrade`.",
         "",
     ]
     if index_text:
@@ -1044,7 +1050,7 @@ def _git_exclude(project: Path, pattern: str, dry_run: bool) -> bool:
     if not dry_run:
         info.mkdir(parents=True, exist_ok=True)
         body = existing.rstrip("\n")
-        block = "# roadmodel-update: agent memory export (personal, never commit)"
+        block = "# roadmodel-upgrade: agent memory export (personal, never commit)"
         exclude.write_text(
             (body + "\n\n" if body else "") + block + "\n" + pattern + "\n", encoding="utf-8"
         )
@@ -1078,7 +1084,7 @@ def _agents_md(project: Path) -> str:
         f"If [`{AGENTS_MEMORY_REL.as_posix()}`]({AGENTS_MEMORY_REL.as_posix()}) exists, read it at the",
         "start of a session: it carries the durable facts about this project that",
         "Claude Code's auto-memory holds — decisions, conventions, gotchas. It is",
-        "local-only (git-excluded) and regenerated by `roadmodel-update`, so it may be",
+        "local-only (git-excluded) and regenerated by `roadmodel-upgrade`, so it may be",
         "absent on a fresh clone; that is expected.",
         "",
         "It is git-excluded, so a file-reading tool that honours ignore rules will",
@@ -1087,10 +1093,13 @@ def _agents_md(project: Path) -> str:
         "",
         "## Commands",
         "",
-        "`roadmap-project`, `roadmap-phase`, `roadmap-step` and `roadmodel-update` are",
-        "installed for every agent on this machine (Codex: `/prompts:roadmap-phase 1`;",
-        "elsewhere: `/roadmap-phase 1`). See docs/agent-parity.md in the roadmodel repo.",
+        "`roadmap-project`, `roadmap-phase`, `roadmap-step`, `roadmap-refresh` and",
+        "`roadmodel-upgrade` are installed for every agent on this machine (Codex:",
+        "`/prompts:roadmap-phase 1`; elsewhere: `/roadmap-phase 1`). See",
+        "docs/agent-parity.md in the roadmodel repo.",
         "",
+        # The marker keeps the updater's old name: /roadmap-step and
+        # /roadmap-refresh recognise the file by this exact line.
         "<!-- Created once by roadmodel-update. Edit freely: it is never overwritten. -->",
     ]
     return "\n".join(lines) + "\n"
@@ -1194,6 +1203,47 @@ def refresh_commands(dry_run: bool = False, agents: Optional[list[str]] = None)
                 target = OPENCODE_DIR / "commands" / f"{name}.md"
                 states.append(f"opencode {_install(target, cmd_md, dry_run)}")
         report.append(f"{name}: " + " · ".join(states))
+    return report + retire_commands(dry_run)
+
+
+def _command_files(name: str) -> list[Path]:
+    """Every file refresh_commands can install for ``name``, for every agent."""
+    files = [
+        CLAUDE_DIR / "commands" / f"{name}.md",
+        CLAUDE_DIR / "skills" / name / "SKILL.md",
+        GEMINI_DIR / "commands" / f"{name}.toml",
+        ANTIGRAVITY_SKILLS_DIR / name / "SKILL.md",
+        CODEX_DIR / "prompts" / f"{name}.md",
+        AGENTS_SKILLS_DIR / name / "SKILL.md",
+        CODEX_LEGACY_SKILLS_DIR / name / "SKILL.md",
+        OPENCODE_DIR / "commands" / f"{name}.md",
+    ]
+    return files + [d / "prompts" / f"{name}.prompt.md" for d in _vscode_user_dirs()]
+
+
+def retire_commands(dry_run: bool = False) -> list[str]:
+    """Remove this updater's copies of RETIRED_COMMANDS. A copy is ours when it
+    carries the updater's filename, which every port of a command body does."""
+    report: list[str] = []
+    for name in RETIRED_COMMANDS:
+        removed = 0
+        for path in _command_files(name):
+            try:
+                ours = path.is_file() and "update_projects.py" in path.read_text(encoding="utf-8")
+            except (OSError, UnicodeDecodeError):
+                ours = False
+            if not ours:
+                continue
+            removed += 1
+            if not dry_run:
+                path.unlink()
+                if path.name == "SKILL.md":
+                    with contextlib.suppress(OSError):
+                        path.parent.rmdir()
+        if removed:
+            report.append(
+                f"{name}: retired — removed {removed} old cop{'y' if removed == 1 else 'ies'}"
+            )
     return report
 
 

{roadmodel-0.2.44 → roadmodel-0.2.45}/src/roadmodel/__init__.py

@@ -1,2 +1,2 @@
 # src/roadmodel/__init__.py
-__version__ = "0.2.44"
+__version__ = "0.2.45"