feat(update): add repo_subdir support for monorepo deployments

Author: hailangvn

SPEC.md

@@ -89,7 +89,7 @@ file values, which take precedence over built-in defaults.
 **Signature**
 
 ```bash
-deploy [--config FILE] configure <instance_name> [<ssh_host>] [<repo_url>] [--type odoo|python|service] [-p <ssh_port>]
+deploy [--config FILE] configure <instance_name> [<ssh_host>] [<repo_url>] [--type odoo|python|service] [-p <ssh_port>] [--force] [--repo-subdir <subdir>]
 ```
 
 **Arguments**
@@ -98,15 +98,16 @@ deploy [--config FILE] configure <instance_name> [<ssh_host>] [<repo_url>] [--ty
 |----------------|------------------------|------------------------------------------------------------------------------|
 | `instance_name` | Always                 | Logical name for the instance (used for paths and service name)             |
 | `ssh_host`      | If not in config       | SSH target, or `localhost` / omit to deploy locally without SSH             |
-| `ssh_port`      | If not in config       | SSH port, default 22                                                        |
 | `repo_url`      | If not in config       | Git repository URL (e.g. `git@github.com:org/repo.git`)                     |
 
 **Options**
 
 | Option         | Default  | Description                                                                                         |
 |----------------|----------|-----------------------------------------------------------------------------------------------------|
 | `--type`       | auto     | Deployment type: `odoo`, `python`, or `service`; auto-detected from instance name prefix if omitted |
+| `-p`           | `22`     | SSH port, default 22                                                                                |
 | `--force`      | `False`  | Re-run steps 3–4 even if the instance directory already exists                                      |
+| `--repo-subdir`| `None`   | Subdirectory within the repository to work on, if any                                               |
 
 **Steps (executed in order)**
 
@@ -170,7 +171,7 @@ deploy [--config FILE] configure <instance_name> [<ssh_host>] [<repo_url>] [--ty
 **Signature**
 
 ```bash
-deploy [--config FILE] update <instance_name> [<ssh_host>] [-p <ssh_port>] [--type odoo|python|service] [--db DATABASE]
+deploy [--config FILE] update <instance_name> [<ssh_host>] [-p <ssh_port>] [--type odoo|python|service] [--db DATABASE] [--ignore-hooks] [--repo-subdir <subdir>]
 ```
 
 **Arguments**
@@ -179,15 +180,16 @@ deploy [--config FILE] update <instance_name> [<ssh_host>] [-p <ssh_port>] [--ty
 |----------------|------------------------|------------------------------------------------------------------------------|
 | `instance_name` | Always                 | Name of the previously configured instance                                  |
 | `ssh_host`      | If not in config       | SSH target, or `localhost` / omit to deploy locally without SSH             |
-| `ssh_port`      | If not in config       | SSH port, default 22                                                        |
 
 **Options**
 
 | Option             | Default           | Description                                              |
 |--------------------|-------------------|----------------------------------------------------------|
 | `--type`           | auto              | Deployment type: `odoo`, `python`, or `service`; auto-detected from instance name prefix if omitted |
+| `-p`               | `22`              | SSH port, default 22                                     |
 | `--db`             | `<instance_name>` | (Odoo only) Override the target database name            |
 | `--ignore-hooks`   | `False`           | Skip all hook execution                                  |
+| `--repo-subdir`    | `None`            | Subdirectory within the repository to work on, if any    |
 
 **Hooks**
 

deploy/command/update.py

@@ -38,6 +38,12 @@
     default=False,
     help="Skip all hook execution.",
 )
+@click.option(
+    "--repo-subdir",
+    "repo_subdir",
+    default=None,
+    help="Subdirectory within the repo to use as the service root (for monorepos).",
+)
 @click.pass_context
 def update(  # noqa: C901
     ctx: click.Context,
@@ -47,6 +53,7 @@ def update(  # noqa: C901
     db: str | None,
     ssh_port: int | None,
     ignore_hooks: bool,
+    repo_subdir: str | None,
 ) -> None:
     """Update an existing deployment instance."""
     cfg = load_config(ctx.obj["config"], instance_name)
@@ -58,6 +65,7 @@ def update(  # noqa: C901
             ssh_port=ssh_port,
             deploy_type=deploy_type,
             db=db,
+            repo_subdir=repo_subdir,
         )
     except ValueError as exc:
         raise click.ClickException(click.style(str(exc), fg="red")) from exc
@@ -71,6 +79,8 @@ def update(  # noqa: C901
     executor = Executor(eff_ssh_host, ctx.obj["verbose"], ssh_port=eff_ssh_port)
     home_dir = executor.capture("echo $HOME")
     instance_path = f"{home_dir}/{instance_name}"
+    eff_repo_subdir: str | None = opts.get("repo_subdir")
+    service_path = f"{instance_path}/{eff_repo_subdir}" if eff_repo_subdir else instance_path
 
     def run_hooks(hook_name: str) -> bool:
         """Execute all commands for *hook_name*. Returns True if all succeeded."""
@@ -127,18 +137,18 @@ def run_hooks(hook_name: str) -> bool:
     # Step 6: Update dependencies / rebuild
     click.secho("\nUpdating dependencies…", fg="green")
     try:
+        executor.run(
+            "if [ -f addons/repos.yaml ]; then cd addons/ && gitaggregate -c repos.yaml; fi",
+            cwd=instance_path,
+        )
         if eff_type == "odoo":
-            executor.run(
-                "if [ -f addons/repos.yaml ]; then cd addons/ && gitaggregate -c repos.yaml; fi",
-                cwd=instance_path,
-            )
             executor.run("odoo-venv update .venv --backup --yes", cwd=instance_path)
         elif eff_type == "python":
-            setup_python_deps(executor, instance_path)
+            setup_python_deps(executor, service_path)
         else:  # service
             build_cmd: str | None = opts.get("build")
             if build_cmd:
-                executor.run(build_cmd, cwd=instance_path)
+                executor.run(build_cmd, cwd=service_path)
     except ExecutorError as exc:
         run_hooks("post-update")
         run_hooks("post-update-fail")