chatup 0.2.6__tar.gz → 0.2.7__tar.gz

{chatup-0.2.6/src/chatup.egg-info → chatup-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatup
-Version: 0.2.6
+Version: 0.2.7
 Summary: ChatArch setup CLI extracted from ChatTool
 Author-email: rexwzh <1073853456@qq.com>
 License-Expression: MIT
@@ -41,7 +41,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
-| 安装 ChatTea-compatible Gitea、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
+| 安装 ChatTea-compatible Gitea、Discourse/Zulip 社区服务配置、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
 
 ## 快速开始
 
@@ -58,6 +58,8 @@ chatup workspace default ~/Playground
 
 ```bash
 chatup gitea --force
+chatup discourse -e discourse-prod --hostname discourse.public.wzhecnu.cn
+chatup zulip -e zulip-prod --external-host zulip.public.wzhecnu.cn --port 3095
 chatup mysql
 chatup nginx
 chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example.invalid --set PROXY_PASS=http://127.0.0.1:3000
@@ -70,10 +72,10 @@ chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 | --- | --- |
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
-| 本地服务安装 | `gitea`、`mysql`、`nginx`、`crs` |
+| 本地服务安装 | `gitea`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置迁移来的 Cursor token。更完整的能力边界见 `docs/capability-map.md`。
+所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.6 → chatup-0.2.7}/README.md

@@ -15,7 +15,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
-| 安装 ChatTea-compatible Gitea、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
+| 安装 ChatTea-compatible Gitea、Discourse/Zulip 社区服务配置、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
 
 ## 快速开始
 
@@ -32,6 +32,8 @@ chatup workspace default ~/Playground
 
 ```bash
 chatup gitea --force
+chatup discourse -e discourse-prod --hostname discourse.public.wzhecnu.cn
+chatup zulip -e zulip-prod --external-host zulip.public.wzhecnu.cn --port 3095
 chatup mysql
 chatup nginx
 chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example.invalid --set PROXY_PASS=http://127.0.0.1:3000
@@ -44,10 +46,10 @@ chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 | --- | --- |
 | 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
-| 本地服务安装 | `gitea`、`mysql`、`nginx`、`crs` |
+| 本地服务安装 | `gitea`、`discourse`、`zulip`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置迁移来的 Cursor token。更完整的能力边界见 `docs/capability-map.md`。
+所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/discourse`、`~/.chatarch/zulip`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。`cursor-agent` 额外注册 ChatEnv `CursorAgent` profile，`discourse`/`zulip` 注册管理员凭据 profile，并支持 `-e/--env` 从 env 文件或 profile 快速配置。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.6 → chatup-0.2.7}/pyproject.toml

@@ -40,6 +40,8 @@ chatup = "chatup.cli:main"
 
 [project.entry-points."chatenv.configs"]
 cursor-agent = "chatup.config:CursorAgentConfig"
+discourse = "chatup.config:DiscourseAdminConfig"
+zulip = "chatup.config:ZulipAdminConfig"
 
 [tool.setuptools.dynamic]
 version = {attr = "chatup.__version__"}

{chatup-0.2.6 → chatup-0.2.7}/src/chatup/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.6"
+__version__ = "0.2.7"

chatup-0.2.7/src/chatup/config.py

@@ -0,0 +1,122 @@
+from __future__ import annotations
+
+from chatenv.fields import BaseEnvConfig, EnvField
+
+
+class CursorAgentConfig(BaseEnvConfig):
+    """ChatEnv schema for Cursor Agent credentials used by ChatUp setup."""
+
+    _title = "Cursor Agent"
+    _aliases = ["cursor-agent", "cursor_agent", "cursor"]
+    _storage_dir = "CursorAgent"
+
+    CURSOR_ACCESS_TOKEN = EnvField(
+        "CURSOR_ACCESS_TOKEN",
+        desc="Cursor Agent access token copied into Cursor auth.json by chatup cursor-agent.",
+        is_sensitive=True,
+    )
+    CURSOR_REFRESH_TOKEN = EnvField(
+        "CURSOR_REFRESH_TOKEN",
+        desc="Cursor Agent refresh token copied into Cursor auth.json by chatup cursor-agent.",
+        is_sensitive=True,
+    )
+    CURSOR_CREDENTIAL_STORE = EnvField(
+        "CURSOR_CREDENTIAL_STORE",
+        default="native",
+        desc="Cursor Agent credential store mode: native or file-wrapper.",
+    )
+
+    @classmethod
+    def test(cls) -> None:
+        """Run a non-network schema smoke for chatenv test."""
+
+        print(f"Testing {cls._title}...")
+        fields = cls.get_fields()
+        expected = {
+            "CURSOR_ACCESS_TOKEN",
+            "CURSOR_REFRESH_TOKEN",
+            "CURSOR_CREDENTIAL_STORE",
+        }
+        missing = expected.difference(fields)
+        if missing:
+            raise RuntimeError(f"Missing Cursor Agent config field(s): {', '.join(sorted(missing))}")
+        if not fields["CURSOR_ACCESS_TOKEN"].is_sensitive or not fields["CURSOR_REFRESH_TOKEN"].is_sensitive:
+            raise RuntimeError("Cursor Agent token fields must be marked sensitive")
+        print("✓ Cursor Agent ChatEnv schema is registered.")
+
+
+class DiscourseAdminConfig(BaseEnvConfig):
+    """ChatEnv schema for ChatUp-managed Discourse bootstrap admin credentials."""
+
+    _title = "Discourse Admin"
+    _aliases = ["discourse", "discourse-admin", "discourse_admin"]
+    _storage_dir = "Discourse"
+
+    DISCOURSE_ADMIN_USERNAME = EnvField(
+        "DISCOURSE_ADMIN_USERNAME",
+        desc="Initial Discourse administrator username used by ChatUp service setup.",
+    )
+    DISCOURSE_ADMIN_EMAIL = EnvField(
+        "DISCOURSE_ADMIN_EMAIL",
+        desc="Initial Discourse administrator email used by ChatUp service setup.",
+    )
+    DISCOURSE_ADMIN_PASSWORD = EnvField(
+        "DISCOURSE_ADMIN_PASSWORD",
+        desc="Initial Discourse administrator password used by ChatUp service setup.",
+        is_sensitive=True,
+    )
+
+    @classmethod
+    def test(cls) -> None:
+        fields = cls.get_fields()
+        expected = {
+            "DISCOURSE_ADMIN_USERNAME",
+            "DISCOURSE_ADMIN_EMAIL",
+            "DISCOURSE_ADMIN_PASSWORD",
+        }
+        missing = expected.difference(fields)
+        if missing:
+            raise RuntimeError(f"Missing Discourse admin config field(s): {', '.join(sorted(missing))}")
+        if not fields["DISCOURSE_ADMIN_PASSWORD"].is_sensitive:
+            raise RuntimeError("Discourse admin password field must be marked sensitive")
+
+
+class ZulipAdminConfig(BaseEnvConfig):
+    """ChatEnv schema for ChatUp-managed Zulip bootstrap admin credentials."""
+
+    _title = "Zulip Admin"
+    _aliases = ["zulip", "zulip-admin", "zulip_admin"]
+    _storage_dir = "Zulip"
+
+    ZULIP_ADMIN_USERNAME = EnvField(
+        "ZULIP_ADMIN_USERNAME",
+        desc="Initial Zulip administrator username recorded by ChatUp service setup.",
+    )
+    ZULIP_ADMIN_EMAIL = EnvField(
+        "ZULIP_ADMIN_EMAIL",
+        desc="Initial Zulip administrator email used for ZULIP_ADMINISTRATOR.",
+    )
+    ZULIP_ADMIN_MAIL = EnvField(
+        "ZULIP_ADMIN_MAIL",
+        desc="Compatibility alias for the initial Zulip administrator email.",
+    )
+    ZULIP_ADMIN_PASSWORD = EnvField(
+        "ZULIP_ADMIN_PASSWORD",
+        desc="Initial Zulip administrator password recorded by ChatUp service setup.",
+        is_sensitive=True,
+    )
+
+    @classmethod
+    def test(cls) -> None:
+        fields = cls.get_fields()
+        expected = {
+            "ZULIP_ADMIN_USERNAME",
+            "ZULIP_ADMIN_EMAIL",
+            "ZULIP_ADMIN_MAIL",
+            "ZULIP_ADMIN_PASSWORD",
+        }
+        missing = expected.difference(fields)
+        if missing:
+            raise RuntimeError(f"Missing Zulip admin config field(s): {', '.join(sorted(missing))}")
+        if not fields["ZULIP_ADMIN_PASSWORD"].is_sensitive:
+            raise RuntimeError("Zulip admin password field must be marked sensitive")

chatup-0.2.7/src/chatup/setup/discourse.py

@@ -0,0 +1,187 @@
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+import click
+from chatenv.paths import get_paths
+
+from chatup.config import DiscourseAdminConfig
+from chatup.interaction import abort_if_force_without_tty, resolve_interactive_mode
+from chatup.setup.service_credentials import (
+    load_chatenv_values,
+    require_values,
+    write_private_env_file,
+)
+from chatup.utils.custom_logger import setup_logger
+
+logger = setup_logger("setup_discourse")
+
+DEFAULT_HOME = get_paths().home_dir / "discourse"
+DEFAULT_REPO = "https://github.com/discourse/discourse_docker.git"
+DEFAULT_HOSTNAME = "discourse.public.wzhecnu.cn"
+DEFAULT_PORT = 3088
+
+ADMIN_KEYS = (
+    "DISCOURSE_ADMIN_USERNAME",
+    "DISCOURSE_ADMIN_EMAIL",
+    "DISCOURSE_ADMIN_PASSWORD",
+)
+
+
+def _configure_logger(log_level="INFO"):
+    global logger
+    logger = setup_logger("setup_discourse", log_level=str(log_level).upper())
+    return logger
+
+
+def run_command(args: list[str], *, cwd: Path | None = None, timeout: int = 600) -> None:
+    subprocess.run([str(arg) for arg in args], cwd=str(cwd) if cwd else None, check=True, timeout=timeout)
+
+
+def render_app_yml(*, hostname: str, port: int, shared_dir: Path, with_ai: bool) -> str:
+    plugins = ["https://github.com/discourse/docker_manager.git"]
+    if with_ai:
+        plugins.append("https://github.com/discourse/discourse-ai.git")
+    plugin_hooks = "\n".join(
+        "\n".join(
+            [
+                "    - exec:",
+                "        cd: $home/plugins",
+                "        cmd:",
+                f"          - git clone {url}",
+            ]
+        )
+        for url in plugins
+    )
+    return f"""templates:
+  - templates/postgres.template.yml
+  - templates/redis.template.yml
+  - templates/web.template.yml
+  - templates/web.ratelimited.template.yml
+
+expose:
+  - \"127.0.0.1:{port}:80\"
+
+params:
+  db_default_text_search_config: \"pg_catalog.english\"
+
+# Credentials and API/model secrets should be managed outside this file.
+# Admin bootstrap values are written by ChatUp to ../secrets/admin.env.
+env:
+  LANG: en_US.UTF-8
+  DISCOURSE_HOSTNAME: {hostname}
+  DISCOURSE_DEVELOPER_EMAILS: ''
+  DISCOURSE_SKIP_EMAIL_SETUP: 1
+
+volumes:
+  - volume:
+      host: {shared_dir}
+      guest: /shared
+  - volume:
+      host: {shared_dir}/log/var-log
+      guest: /var/log
+
+hooks:
+  after_code:
+{plugin_hooks}
+
+run:
+  - exec: echo \"Beginning of custom commands\"
+  - exec: echo \"End of custom commands\"
+"""
+
+
+def ensure_directories(home: Path) -> dict[str, Path]:
+    paths = {
+        "home": home,
+        "docker": home / "docker",
+        "containers": home / "docker" / "containers",
+        "secrets": home / "secrets",
+        "logs": home / "logs",
+        "backups": home / "backups",
+        "shared": home / "shared" / "standalone",
+        "shared_log": home / "shared" / "standalone" / "log" / "var-log",
+    }
+    for path in paths.values():
+        path.mkdir(parents=True, exist_ok=True)
+    paths["secrets"].chmod(0o700)
+    return paths
+
+
+def clone_or_update_discourse_docker(docker_dir: Path, repo: str) -> None:
+    if (docker_dir / ".git").exists():
+        run_command(["git", "fetch", "--all", "--prune"], cwd=docker_dir)
+        run_command(["git", "pull", "--ff-only"], cwd=docker_dir)
+        return
+    if any(docker_dir.iterdir()):
+        raise click.ClickException(f"Discourse docker dir is not empty and not a git repo: {docker_dir}")
+    run_command(["git", "clone", repo, str(docker_dir)], timeout=900)
+
+
+def setup_discourse(
+    *,
+    home: str | Path = DEFAULT_HOME,
+    hostname: str = DEFAULT_HOSTNAME,
+    port: int = DEFAULT_PORT,
+    env_ref: str | Path | None = None,
+    env_profile: str | None = None,
+    write_admin_env: bool = True,
+    write_app_yml: bool = True,
+    clone: bool = False,
+    repo: str = DEFAULT_REPO,
+    with_ai: bool = True,
+    force: bool = False,
+    interactive=None,
+    log_level="INFO",
+):
+    _configure_logger(log_level)
+    usage = "Usage: chatup discourse [--home PATH] [-e ENV|--env-profile PROFILE]"
+    interactive, can_prompt, force_interactive, _, _ = resolve_interactive_mode(
+        interactive=interactive,
+        auto_prompt_condition=False,
+    )
+    abort_if_force_without_tty(force_interactive, can_prompt, usage)
+
+    home_path = Path(home).expanduser().resolve()
+    paths = ensure_directories(home_path)
+
+    values, source = load_chatenv_values(DiscourseAdminConfig, env_ref=env_ref, env_profile=env_profile)
+    if write_admin_env:
+        require_values(values, ADMIN_KEYS, label="Discourse admin")
+        admin_env = write_private_env_file(paths["secrets"] / "admin.env", values, ADMIN_KEYS)
+    else:
+        admin_env = None
+
+    app_yml = paths["containers"] / "app.yml"
+    if write_app_yml:
+        if app_yml.exists() and not force:
+            logger.info("Keeping existing Discourse app.yml at %s", app_yml)
+        else:
+            app_yml.write_text(
+                render_app_yml(hostname=hostname, port=port, shared_dir=paths["shared"], with_ai=with_ai),
+                encoding="utf-8",
+            )
+            app_yml.chmod(0o640)
+
+    if clone:
+        clone_or_update_discourse_docker(paths["docker"], repo)
+
+    result = {
+        "home": str(home_path),
+        "docker_dir": str(paths["docker"]),
+        "app_yml": str(app_yml),
+        "admin_env": str(admin_env) if admin_env else None,
+        "admin_source": source if write_admin_env else None,
+        "hostname": hostname,
+        "port": port,
+        "cloned": clone,
+    }
+    click.echo(f"Discourse home: {home_path}")
+    if write_admin_env:
+        click.echo(f"Discourse admin env: {admin_env} (managed from ChatEnv; values hidden)")
+    if write_app_yml:
+        click.echo(f"Discourse app.yml: {app_yml}")
+    if clone:
+        click.echo(f"Discourse docker repo: {paths['docker']}")
+    return result

{chatup-0.2.6 → chatup-0.2.7}/src/chatup/setup/elements.py

@@ -17,6 +17,13 @@ from chatup.setup.crs import (
     DEFAULT_REDIS_PORT,
 )
 from chatup.setup.docker import setup_docker
+from chatup.setup.discourse import (
+    DEFAULT_HOME as DEFAULT_DISCOURSE_HOME,
+    DEFAULT_HOSTNAME as DEFAULT_DISCOURSE_HOSTNAME,
+    DEFAULT_PORT as DEFAULT_DISCOURSE_PORT,
+    DEFAULT_REPO as DEFAULT_DISCOURSE_REPO,
+    setup_discourse,
+)
 from chatup.setup.frp import setup_frp
 from chatup.setup.gitea import (
     DEFAULT_BASE_URL as DEFAULT_GITEA_BASE_URL,
@@ -46,10 +53,19 @@ from chatup.setup.nginx import (
     setup_nginx,
 )
 from chatup.setup.opencode import setup_opencode
-from chatup.setup.zsh import setup_zsh
 from chatup.setup.nodejs import setup_nodejs
 from chatup.setup.uv import DEFAULT_PYTHON_VERSION, DEFAULT_VENV_PATH, setup_uv
 from chatup.setup.workspace import setup_workspace
+from chatup.setup.zsh import setup_zsh
+from chatup.setup.zulip import (
+    DEFAULT_BIND_ADDRESS as DEFAULT_ZULIP_BIND_ADDRESS,
+    DEFAULT_EXTERNAL_HOST as DEFAULT_ZULIP_EXTERNAL_HOST,
+    DEFAULT_HOME as DEFAULT_ZULIP_HOME,
+    DEFAULT_IMAGE as DEFAULT_ZULIP_IMAGE,
+    DEFAULT_PORT as DEFAULT_ZULIP_PORT,
+    DEFAULT_POSTGRES_IMAGE as DEFAULT_ZULIP_POSTGRES_IMAGE,
+    setup_zulip,
+)
 
 
 @dataclass(frozen=True)
@@ -186,6 +202,74 @@ def gitea_setup(
     )
 
 
+def discourse_setup(
+    home,
+    hostname,
+    port,
+    env,
+    env_profile,
+    write_admin_env,
+    write_app_yml,
+    clone,
+    repo,
+    with_ai,
+    force,
+    interactive,
+    log_level,
+):
+    setup_discourse(
+        home=home,
+        hostname=hostname,
+        port=port,
+        env_ref=env,
+        env_profile=env_profile,
+        write_admin_env=write_admin_env,
+        write_app_yml=write_app_yml,
+        clone=clone,
+        repo=repo,
+        with_ai=with_ai,
+        force=force,
+        interactive=interactive,
+        log_level=log_level,
+    )
+
+
+def zulip_setup(
+    home,
+    image,
+    postgres_image,
+    external_host,
+    bind_address,
+    port,
+    env,
+    env_profile,
+    write_admin_env,
+    write_compose,
+    pull,
+    start,
+    force,
+    interactive,
+    log_level,
+):
+    setup_zulip(
+        home=home,
+        image=image,
+        postgres_image=postgres_image,
+        external_host=external_host,
+        bind_address=bind_address,
+        port=port,
+        env_ref=env,
+        env_profile=env_profile,
+        write_admin_env=write_admin_env,
+        write_compose=write_compose,
+        pull=pull,
+        start=start,
+        force=force,
+        interactive=interactive,
+        log_level=log_level,
+    )
+
+
 def mysql_setup(
     version,
     home,
@@ -602,6 +686,126 @@ SETUP_COMMAND_ELEMENTS = (
             ),
         ),
     ),
+    SetupCommandElement(
+        name="discourse",
+        help="Prepare ChatArch-contained Discourse docker config and ChatEnv-managed admin credentials.",
+        callback=discourse_setup,
+        options=(
+            LOG_LEVEL_OPTION,
+            SetupOptionElement(
+                param_decls=("--home",),
+                kwargs={"default": str(DEFAULT_DISCOURSE_HOME), "show_default": True, "type": click.Path(path_type=Path)},
+            ),
+            SetupOptionElement(
+                param_decls=("--hostname",),
+                kwargs={"default": DEFAULT_DISCOURSE_HOSTNAME, "show_default": True},
+            ),
+            SetupOptionElement(
+                param_decls=("--port",),
+                kwargs={"default": DEFAULT_DISCOURSE_PORT, "show_default": True, "type": int},
+            ),
+            SetupOptionElement(
+                param_decls=("-e", "--env"),
+                kwargs={"default": None, "help": "ChatEnv profile name or env file with DISCOURSE_ADMIN_* values."},
+            ),
+            SetupOptionElement(
+                param_decls=("--env-profile",),
+                kwargs={"default": None, "help": "Explicit ChatEnv profile for Discourse admin values."},
+            ),
+            SetupOptionElement(
+                param_decls=("--write-admin-env/--no-write-admin-env",),
+                kwargs={"default": True, "show_default": True, "help": "Write secrets/admin.env from ChatEnv values."},
+            ),
+            SetupOptionElement(
+                param_decls=("--write-app-yml/--no-write-app-yml",),
+                kwargs={"default": True, "show_default": True, "help": "Write containers/app.yml using ChatArch-local paths."},
+            ),
+            SetupOptionElement(
+                param_decls=("--clone/--no-clone",),
+                kwargs={"default": False, "show_default": True, "help": "Clone/update discourse_docker into HOME/docker."},
+            ),
+            SetupOptionElement(
+                param_decls=("--repo",),
+                kwargs={"default": DEFAULT_DISCOURSE_REPO, "show_default": True, "help": "discourse_docker repository URL."},
+            ),
+            SetupOptionElement(
+                param_decls=("--with-ai/--without-ai",),
+                kwargs={"default": True, "show_default": True, "help": "Include discourse-ai plugin hook in generated app.yml."},
+            ),
+            SetupOptionElement(
+                param_decls=("--force", "-f"),
+                kwargs={"is_flag": True, "help": "Overwrite generated app.yml when it already exists."},
+            ),
+            SetupOptionElement(
+                param_decls=("--interactive/--no-interactive", "-i/-I"),
+                kwargs={"default": None, "help": INTERACTIVE_OPTION_HELP},
+            ),
+        ),
+    ),
+    SetupCommandElement(
+        name="zulip",
+        help="Prepare ChatArch-contained Zulip Docker Compose config and ChatEnv-managed admin credentials.",
+        callback=zulip_setup,
+        options=(
+            LOG_LEVEL_OPTION,
+            SetupOptionElement(
+                param_decls=("--home",),
+                kwargs={"default": str(DEFAULT_ZULIP_HOME), "show_default": True, "type": click.Path(path_type=Path)},
+            ),
+            SetupOptionElement(
+                param_decls=("--image",),
+                kwargs={"default": DEFAULT_ZULIP_IMAGE, "show_default": True},
+            ),
+            SetupOptionElement(
+                param_decls=("--postgres-image",),
+                kwargs={"default": DEFAULT_ZULIP_POSTGRES_IMAGE, "show_default": True},
+            ),
+            SetupOptionElement(
+                param_decls=("--external-host",),
+                kwargs={"default": DEFAULT_ZULIP_EXTERNAL_HOST, "show_default": True},
+            ),
+            SetupOptionElement(
+                param_decls=("--bind-address",),
+                kwargs={"default": DEFAULT_ZULIP_BIND_ADDRESS, "show_default": True},
+            ),
+            SetupOptionElement(
+                param_decls=("--port",),
+                kwargs={"default": DEFAULT_ZULIP_PORT, "show_default": True, "type": int},
+            ),
+            SetupOptionElement(
+                param_decls=("-e", "--env"),
+                kwargs={"default": None, "help": "ChatEnv profile name or env file with ZULIP_ADMIN_* values."},
+            ),
+            SetupOptionElement(
+                param_decls=("--env-profile",),
+                kwargs={"default": None, "help": "Explicit ChatEnv profile for Zulip admin values."},
+            ),
+            SetupOptionElement(
+                param_decls=("--write-admin-env/--no-write-admin-env",),
+                kwargs={"default": True, "show_default": True, "help": "Write secrets/admin.env from ChatEnv values."},
+            ),
+            SetupOptionElement(
+                param_decls=("--write-compose/--no-write-compose",),
+                kwargs={"default": True, "show_default": True, "help": "Write ChatArch-contained compose.yaml."},
+            ),
+            SetupOptionElement(
+                param_decls=("--pull/--no-pull",),
+                kwargs={"default": False, "show_default": True, "help": "Run Docker Compose pull after writing config."},
+            ),
+            SetupOptionElement(
+                param_decls=("--start/--no-start",),
+                kwargs={"default": False, "show_default": True, "help": "Run Docker Compose up -d after writing config."},
+            ),
+            SetupOptionElement(
+                param_decls=("--force", "-f"),
+                kwargs={"is_flag": True, "help": "Overwrite generated compose.yaml when it already exists."},
+            ),
+            SetupOptionElement(
+                param_decls=("--interactive/--no-interactive", "-i/-I"),
+                kwargs={"default": None, "help": INTERACTIVE_OPTION_HELP},
+            ),
+        ),
+    ),
     SetupCommandElement(
         name="mysql",
         help="Install and prepare a ChatData-compatible user-level MySQL runtime.",