feat: add upgrade command

Author: wangtsiao

.github/workflows/release.yml

@@ -120,37 +120,21 @@ jobs:
 
       - name: Generate release notes
         run: |
-          cat > release-notes.md <<- NOTES
+          cat > release-notes.md <<'NOTES'
           ## Install
 
-          ### Build from source
+          ### Linux / macOS
 
-          \`\`\`bash
-          git clone https://github.com/${{ github.repository }}.git
-          cd devo
-          cargo build --release
+          ```bash
+          curl -fsSL https://raw.githubusercontent.com/7df-lab/devo/main/install.sh | sh
+          ```
 
-          # Linux / macOS
-          ./target/release/devo onboard
-
-          # Windows
-          .\\target\\release\\devo onboard
-          \`\`\`
-
-          ### Prebuilt binary
-
-          Download the archive for your platform from the Assets section below, extract it, and place the \`devo\` (or \`devo.exe\` on Windows) binary somewhere in your \`PATH\`.
-
-          Supported platforms:
-          - Linux x86_64 (\`x86_64-unknown-linux-musl\`)
-          - Linux ARM64 (\`aarch64-unknown-linux-musl\`)
-          - macOS Intel (\`x86_64-apple-darwin\`)
-          - macOS Apple Silicon (\`aarch64-apple-darwin\`)
-          - Windows x86_64 (\`x86_64-pc-windows-msvc\`)
+          ### Windows
 
+          ```powershell
+          irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
+          ```
           ---
-
-          Full changelog at [commits](https://github.com/${{ github.repository }}/commits/${{ github.ref_name }}).
           NOTES
 
       - name: Create release

README.ja.md

@@ -117,6 +117,15 @@ Windows:
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
 ```
 
+既存のインストールを最新 release にアップグレードするには:
+
+```bash
+devo upgrade
+```
+
+アップグレードコマンドは同じプラットフォーム用インストーラーを実行し、
+インストーラーは `Version: v0.1.12 -> v0.1.15` のようにバージョン遷移を表示します。
+
 <details>
 <summary>オフラインインストール</summary>
 

README.md

@@ -126,6 +126,15 @@ Windows:
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
 ```
 
+Upgrade an existing installation to the latest release:
+
+```bash
+devo upgrade
+```
+
+The upgrade command runs the same platform installer, and the installer prints
+the version transition, for example `Version: v0.1.12 -> v0.1.15`.
+
 <details>
 <summary>Offline Installation</summary>
 

README.ru.md

@@ -129,6 +129,15 @@ Windows:
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
 ```
 
+Обновление существующей установки до последнего release:
+
+```bash
+devo upgrade
+```
+
+Команда обновления запускает тот же установщик для текущей платформы, а
+установщик выводит переход версии, например `Version: v0.1.12 -> v0.1.15`.
+
 <details>
 <summary>Офлайн-установка</summary>
 

README.zh-Hans.md

@@ -115,6 +115,15 @@ Windows:
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
 ```
 
+将现有安装升级到最新 release：
+
+```bash
+devo upgrade
+```
+
+升级命令会执行同一套平台安装器，安装器会打印版本变化，例如
+`Version: v0.1.12 -> v0.1.15`。
+
 <details>
 <summary>离线安装</summary>
 

README.zh-Hant.md

@@ -115,6 +115,15 @@ Windows:
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm 'https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1' | iex
 ```
 
+將現有安裝升級到最新 release：
+
+```bash
+devo upgrade
+```
+
+升級命令會執行同一套平台安裝器，安裝器會列印版本變化，例如
+`Version: v0.1.12 -> v0.1.15`。
+
 <details>
 <summary>離線安裝</summary>
 

apps/web/content/docs/install.mdx

@@ -31,6 +31,17 @@ Preinstall the local Hugging Face model used by semantic `code_search`:
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1 | iex
 ```
 
+## Upgrade
+
+Upgrade an existing installation to the latest release:
+
+```bash
+devo upgrade
+```
+
+The upgrade command runs the same platform installer. The installer prints the
+version transition, for example `Version: v0.1.12 -> v0.1.15`.
+
 The model is installed under
 `<DEVO_HOME>/local-models/minishlab--potion-code-16M`.
 

apps/web/content/docs/install.zh.mdx

@@ -31,6 +31,17 @@ curl.exe -fsSL https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1 |
 $env:DEVO_INSTALL_CODE_SEARCH_MODEL = "1"; irm https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1 | iex
 ```
 
+## 升级
+
+将现有安装升级到最新 release：
+
+```bash
+devo upgrade
+```
+
+升级命令会执行同一套平台安装器。安装器会打印版本变化，例如
+`Version: v0.1.12 -> v0.1.15`。
+
 模型会安装到 `<DEVO_HOME>/local-models/minishlab--potion-code-16M`。
 
 ## 从源码构建

crates/cli/src/main.rs

@@ -21,11 +21,13 @@ use tracing_subscriber::filter::LevelFilter;
 mod agent_command;
 mod doctor_command;
 mod prompt_command;
+mod upgrade_command;
 
 use agent_command::run_agent;
 use doctor_command::run_doctor;
 use prompt_command::PromptOutputFormat;
 use prompt_command::run_prompt;
+use upgrade_command::run_upgrade;
 
 /// Top-level `devo` command that dispatches to interactive agent mode or one
 /// of the supporting runtime subcommands.
@@ -162,6 +164,7 @@ async fn run_cli() -> Result<()> {
             let _logging = install_logging(&cli)?;
             run_doctor().await
         }
+        Some(Command::Upgrade) => run_upgrade(),
         Some(Command::Resume { session_id }) => {
             maybe_print_startup_update(&cli).await;
             let _logging = install_logging(&cli)?;
@@ -225,6 +228,8 @@ enum Command {
     },
     /// Diagnose configuration, provider connectivity, and system health.
     Doctor,
+    /// Upgrade Devo to the latest released version.
+    Upgrade,
     /// Start the runtime server process.
     #[command(hide = true)]
     Server {
@@ -467,6 +472,16 @@ mod tests {
         }
     }
 
+    #[test]
+    fn cli_parses_upgrade_subcommand() {
+        let cli = Cli::try_parse_from(["devo", "upgrade"]).expect("parse upgrade");
+
+        match cli.command {
+            Some(Command::Upgrade) => {}
+            other => panic!("expected upgrade command, got {other:?}"),
+        }
+    }
+
     #[test]
     fn exit_messages_includes_usage_and_resume_hint() {
         let session_id = SessionId::new();

crates/cli/src/upgrade_command.rs

@@ -0,0 +1,81 @@
+use std::process::Command;
+
+use anyhow::Context;
+use anyhow::Result;
+use anyhow::bail;
+
+#[cfg(not(windows))]
+const INSTALL_SH_URL: &str = "https://raw.githubusercontent.com/7df-lab/devo/main/install.sh";
+#[cfg(windows)]
+const INSTALL_PS1_URL: &str = "https://raw.githubusercontent.com/7df-lab/devo/main/install.ps1";
+
+pub fn run_upgrade() -> Result<()> {
+    run_platform_upgrade()
+}
+
+#[cfg(not(windows))]
+fn run_platform_upgrade() -> Result<()> {
+    let status = Command::new("sh")
+        .arg("-c")
+        .arg(unix_upgrade_script())
+        .status()
+        .context("run install.sh for devo upgrade")?;
+
+    if !status.success() {
+        bail!("devo upgrade failed with status {status}");
+    }
+
+    Ok(())
+}
+
+#[cfg(not(windows))]
+fn unix_upgrade_script() -> String {
+    format!(
+        r#"set -eu
+command -v curl >/dev/null 2>&1 || {{
+    printf '%s\n' "Error: 'curl' is required but not installed." >&2
+    exit 1
+}}
+tmp_dir="$(mktemp -d "${{TMPDIR:-/tmp}}/devo-upgrade.XXXXXX")"
+trap 'rm -rf "$tmp_dir"' EXIT INT TERM
+curl -fsSL '{INSTALL_SH_URL}' -o "$tmp_dir/install.sh"
+sh "$tmp_dir/install.sh"
+"#
+    )
+}
+
+#[cfg(windows)]
+fn run_platform_upgrade() -> Result<()> {
+    use std::process::Stdio;
+
+    let parent_pid = std::process::id();
+    Command::new("powershell.exe")
+        .args([
+            "-NoProfile",
+            "-ExecutionPolicy",
+            "Bypass",
+            "-Command",
+            &windows_upgrade_script(parent_pid),
+        ])
+        .stdin(Stdio::null())
+        .spawn()
+        .context("start install.ps1 for devo upgrade")?;
+
+    println!("Started devo upgrade with install.ps1.");
+    println!("The installer will continue after this devo.exe process exits.");
+    Ok(())
+}
+
+#[cfg(windows)]
+fn windows_upgrade_script(parent_pid: u32) -> String {
+    format!(
+        r#"$ErrorActionPreference = 'Stop'
+$parent = Get-Process -Id {parent_pid} -ErrorAction SilentlyContinue
+if ($parent) {{
+    Wait-Process -Id {parent_pid}
+}}
+$script = Invoke-WebRequest -UseBasicParsing -Uri '{INSTALL_PS1_URL}'
+Invoke-Expression $script.Content
+"#
+    )
+}