chatup 0.2.3__tar.gz → 0.2.5__tar.gz

{chatup-0.2.3/src/chatup.egg-info → chatup-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatup
-Version: 0.2.3
+Version: 0.2.5
 Summary: ChatArch setup CLI extracted from ChatTool
 Author-email: rexwzh <1073853456@qq.com>
 License-Expression: MIT
@@ -37,7 +37,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 场景 | 文档 |
 | --- | --- |
 | 从空机器验证 ChatUp、Python runtime 和 workspace | `docs/quickstart.md` |
-| 查看完整一级 CLI 树与 CFT/ChromeDriver 独立 contract | `docs/cli-tree.md` |
+| 阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract | `docs/cli-tree.md` |
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
@@ -50,6 +50,7 @@ chatup --help
 chatup doctor
 chatup uv
 chatup chrome-for-testing install --channel stable -I
+chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
@@ -67,12 +68,12 @@ chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 
 | 能力组 | 命令 |
 | --- | --- |
-| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`frp` |
+| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
 | 本地服务安装 | `gitea`、`mysql`、`nginx`、`crs` |
-| Agent 工具链 | `cc-connect`、`claude`、`codex`、`opencode`、`hermes`、`lark-cli` |
+| Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
+所有新增安装项默认目录都收敛到 `~/.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`。
 
 ## 开发
 

{chatup-0.2.3 → chatup-0.2.5}/README.md

@@ -11,7 +11,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 场景 | 文档 |
 | --- | --- |
 | 从空机器验证 ChatUp、Python runtime 和 workspace | `docs/quickstart.md` |
-| 查看完整一级 CLI 树与 CFT/ChromeDriver 独立 contract | `docs/cli-tree.md` |
+| 阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract | `docs/cli-tree.md` |
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
@@ -24,6 +24,7 @@ chatup --help
 chatup doctor
 chatup uv
 chatup chrome-for-testing install --channel stable -I
+chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
@@ -41,12 +42,12 @@ chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 
 | 能力组 | 命令 |
 | --- | --- |
-| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`frp` |
+| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
 | 本地服务安装 | `gitea`、`mysql`、`nginx`、`crs` |
-| Agent 工具链 | `cc-connect`、`claude`、`codex`、`opencode`、`hermes`、`lark-cli` |
+| Agent 工具链 | `cc-connect`、`claude`、`codex`、`cursor-agent`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
+所有新增安装项默认目录都收敛到 `~/.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`。
 
 ## 开发
 

{chatup-0.2.3 → chatup-0.2.5}/pyproject.toml

@@ -38,6 +38,9 @@ docs = [
 [project.scripts]
 chatup = "chatup.cli:main"
 
+[project.entry-points."chatenv.configs"]
+cursor-agent = "chatup.config:CursorAgentConfig"
+
 [tool.setuptools.dynamic]
 version = {attr = "chatup.__version__"}
 

{chatup-0.2.3 → chatup-0.2.5}/src/chatup/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.3"
+__version__ = "0.2.5"

{chatup-0.2.3 → chatup-0.2.5}/src/chatup/cli.py

@@ -5,6 +5,7 @@ import click
 from chatup import __version__
 from chatup.commands.chrome_for_testing import cli as chrome_for_testing_cli
 from chatup.commands.chromedriver import cli as chromedriver_cli
+from chatup.commands.playwright import cli as playwright_cli
 from chatup.setup.cli import register_setup_commands
 
 
@@ -23,6 +24,7 @@ def doctor() -> None:
 register_setup_commands(main)
 main.add_command(chrome_for_testing_cli)
 main.add_command(chromedriver_cli)
+main.add_command(playwright_cli)
 
 
 if __name__ == "__main__":

{chatup-0.2.3 → chatup-0.2.5}/src/chatup/commands/chrome_for_testing.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from typing import Any
 
 import click
-from chatstyle import (
+from chatup.interaction import (
     CommandField,
     CommandSchema,
     add_interactive_option,

{chatup-0.2.3 → chatup-0.2.5}/src/chatup/commands/chromedriver.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from typing import Any
 
 import click
-from chatstyle import (
+from chatup.interaction import (
     CommandField,
     CommandSchema,
     add_interactive_option,

chatup-0.2.5/src/chatup/commands/playwright.py

@@ -0,0 +1,213 @@
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+from typing import Any
+
+import click
+from chatup.interaction import (
+    CommandField,
+    CommandSchema,
+    add_interactive_option,
+    resolve_command_inputs,
+)
+
+import chatup.playwright as backend
+
+OUTPUT_TYPES = ("text", "json")
+
+
+def _validate_version(value: Any, _values: dict[str, Any]) -> str | None:
+    if re.fullmatch(r"\d+\.\d+\.\d+", str(value).strip()):
+        return None
+    return "Playwright version must contain three numeric components"
+
+
+VERSION_SCHEMA = CommandSchema(
+    name="playwright version",
+    fields=(
+        CommandField(
+            "version",
+            prompt="Exact Playwright version",
+            required=True,
+            normalizer=lambda value: str(value).strip(),
+            validator=_validate_version,
+        ),
+    ),
+)
+
+
+def _resolve_version(version: str | None, interactive: bool | None, action: str) -> str:
+    values = resolve_command_inputs(
+        schema=VERSION_SCHEMA,
+        provided={"version": version},
+        interactive=interactive,
+        usage=f"Usage: chatup playwright {action} [VERSION] [-i|-I]",
+    )
+    return str(values["version"])
+
+
+def _call(operation):
+    try:
+        return operation()
+    except backend.PlaywrightError as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
+def _emit(payload: dict[str, Any], output: str) -> None:
+    if output.lower() == "json":
+        click.echo(json.dumps(payload, indent=2, sort_keys=True))
+        return
+    for key, value in payload.items():
+        if value is not None:
+            click.echo(f"{key}: {value}")
+
+
+@click.group(name="playwright")
+def cli() -> None:
+    """Manage user-level Playwright browser installations."""
+
+
+@cli.command(name="install")
+@click.argument("version", required=False)
+@click.option(
+    "--browser",
+    type=click.Choice(backend.SUPPORTED_BROWSERS, case_sensitive=False),
+    default="chromium",
+    show_default=True,
+)
+@click.option(
+    "--home",
+    type=click.Path(path_type=Path, file_okay=False),
+    default=backend.DEFAULT_HOME,
+    show_default=True,
+)
+@click.option("--force", is_flag=True, help="Atomically replace an existing installation.")
+@click.option(
+    "--doctor/--no-doctor",
+    default=True,
+    show_default=True,
+    help="Probe the installed browser version.",
+)
+@click.option(
+    "--output",
+    type=click.Choice(OUTPUT_TYPES, case_sensitive=False),
+    default="text",
+    show_default=True,
+)
+@add_interactive_option
+def install_command(
+    version: str | None,
+    browser: str,
+    home: Path,
+    force: bool,
+    doctor: bool,
+    output: str,
+    interactive: bool | None,
+) -> None:
+    """Install one exact Playwright package and browser."""
+
+    exact = _resolve_version(version, interactive, "install")
+    installation = _call(
+        lambda: backend.install(
+            exact,
+            browser=browser,
+            home=home,
+            force=force,
+        )
+    )
+    health = _call(lambda: backend.doctor(installation, execute=doctor))
+    _emit(health, output)
+    if health["status"] != "ready":
+        raise click.ClickException(
+            "Playwright installation is unhealthy: " + ", ".join(health["errors"])
+        )
+
+
+@cli.command(name="path")
+@click.argument("version", required=False)
+@click.option(
+    "--browser",
+    type=click.Choice(backend.SUPPORTED_BROWSERS, case_sensitive=False),
+    default="chromium",
+    show_default=True,
+)
+@click.option(
+    "--home",
+    type=click.Path(path_type=Path, file_okay=False),
+    default=backend.DEFAULT_HOME,
+    show_default=True,
+)
+@click.option(
+    "--output",
+    type=click.Choice(OUTPUT_TYPES, case_sensitive=False),
+    default="text",
+    show_default=True,
+)
+@add_interactive_option
+def path_command(
+    version: str | None,
+    browser: str,
+    home: Path,
+    output: str,
+    interactive: bool | None,
+) -> None:
+    """Print the browser executable path for an installed Playwright version."""
+
+    exact = _resolve_version(version, interactive, "path")
+    installation = _call(
+        lambda: backend.resolve(exact, browser=browser, home=home)
+    )
+    if output.lower() == "json":
+        _emit(installation.to_dict(), output)
+    else:
+        click.echo(installation.binary_path)
+
+
+@cli.command(name="doctor")
+@click.argument("version", required=False)
+@click.option(
+    "--browser",
+    type=click.Choice(backend.SUPPORTED_BROWSERS, case_sensitive=False),
+    default="chromium",
+    show_default=True,
+)
+@click.option(
+    "--home",
+    type=click.Path(path_type=Path, file_okay=False),
+    default=backend.DEFAULT_HOME,
+    show_default=True,
+)
+@click.option(
+    "--execute/--no-execute",
+    default=True,
+    show_default=True,
+)
+@click.option(
+    "--output",
+    type=click.Choice(OUTPUT_TYPES, case_sensitive=False),
+    default="text",
+    show_default=True,
+)
+@add_interactive_option
+def doctor_command(
+    version: str | None,
+    browser: str,
+    home: Path,
+    execute: bool,
+    output: str,
+    interactive: bool | None,
+) -> None:
+    """Validate one installed Playwright browser."""
+
+    exact = _resolve_version(version, interactive, "doctor")
+    installation = _call(
+        lambda: backend.resolve(exact, browser=browser, home=home)
+    )
+    health = _call(lambda: backend.doctor(installation, execute=execute))
+    _emit(health, output)
+    if health["status"] != "ready":
+        raise click.ClickException(
+            "Playwright installation is unhealthy: " + ", ".join(health["errors"])
+        )

chatup-0.2.5/src/chatup/config.py

@@ -0,0 +1,45 @@
+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.")

{chatup-0.2.3 → chatup-0.2.5}/src/chatup/interaction/command_schema.py

@@ -8,11 +8,27 @@ from chatstyle import (
     add_interactive_option,
 )
 from chatstyle import resolve_command_inputs as _resolve_command_inputs
-from chatstyle.tui.prompt import ask_confirm, ask_path, ask_select, ask_text
+import chatstyle.tui.prompt as prompt_module
 
 from .policy import resolve_interactive_mode
 
 
+def ask_confirm(*args, **kwargs):
+    return prompt_module.ask_confirm(*args, **kwargs)
+
+
+def ask_path(*args, **kwargs):
+    return prompt_module.ask_path(*args, **kwargs)
+
+
+def ask_select(*args, **kwargs):
+    return prompt_module.ask_select(*args, **kwargs)
+
+
+def ask_text(*args, **kwargs):
+    return prompt_module.ask_text(*args, **kwargs)
+
+
 def resolve_command_inputs(*, schema, provided, interactive, usage):
     """Resolve command inputs through ChatStyle while preserving old patch points."""
 
@@ -27,10 +43,10 @@ def resolve_command_inputs(*, schema, provided, interactive, usage):
 
 
 class _PromptRuntime:
-    ask_confirm = staticmethod(lambda *args, **kwargs: ask_confirm(*args, **kwargs))
-    ask_path = staticmethod(lambda *args, **kwargs: ask_path(*args, **kwargs))
-    ask_select = staticmethod(lambda *args, **kwargs: ask_select(*args, **kwargs))
-    ask_text = staticmethod(lambda *args, **kwargs: ask_text(*args, **kwargs))
+    ask_confirm = staticmethod(ask_confirm)
+    ask_path = staticmethod(ask_path)
+    ask_select = staticmethod(ask_select)
+    ask_text = staticmethod(ask_text)
 
 
 def _resolve_interactive_for_chatstyle(*, interactive, auto_prompt_condition):

{chatup-0.2.3 → chatup-0.2.5}/src/chatup/interaction/policy.py

@@ -1,13 +1,15 @@
 """Interactive policy helpers shared across CLI commands."""
 
+import os
+
 import click
+import chatstyle.core.interactive as interactive_module
 
 from chatstyle import FORCE_INTERACTIVE_NO_TTY_MESSAGE
-from chatstyle import is_interactive_available as _is_interactive_available
 
 
 def is_interactive_available():
-    return _is_interactive_available()
+    return interactive_module.is_interactive_available()
 
 
 def normalize_interactive(interactive):
@@ -24,11 +26,23 @@ def normalize_interactive(interactive):
     return interactive
 
 
+def _auto_prompt_enabled() -> bool:
+    value = os.environ.get("CHATARCH_AUTO_PROMPT")
+    if value is None:
+        return True
+    return value.strip().lower() not in {"0", "false", "no", "off"}
+
+
 def resolve_interactive_mode(interactive, auto_prompt_condition):
     interactive = normalize_interactive(interactive)
     can_prompt = is_interactive_available()
     force_interactive = interactive is True
-    auto_interactive = interactive is None and can_prompt and auto_prompt_condition
+    auto_interactive = (
+        interactive is None
+        and can_prompt
+        and auto_prompt_condition
+        and _auto_prompt_enabled()
+    )
     need_prompt = force_interactive or auto_interactive
     return interactive, can_prompt, force_interactive, auto_interactive, need_prompt
 

chatup-0.2.5/src/chatup/playwright.py

@@ -0,0 +1,62 @@
+"""Public API for ChatArch-managed Playwright browsers."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from chatup.runtime.playwright import (
+    DEFAULT_PLAYWRIGHT_HOME,
+    SUPPORTED_PLAYWRIGHT_BROWSERS,
+    PlaywrightBrowserInstallation,
+    PlaywrightError,
+    doctor_playwright_browser,
+    install_playwright_browser,
+    resolve_playwright_browser,
+)
+
+DEFAULT_HOME = DEFAULT_PLAYWRIGHT_HOME
+SUPPORTED_BROWSERS = SUPPORTED_PLAYWRIGHT_BROWSERS
+
+
+def install(
+    version: str,
+    *,
+    browser: str = "chromium",
+    home: Path | str | None = None,
+    force: bool = False,
+) -> PlaywrightBrowserInstallation:
+    return install_playwright_browser(
+        version,
+        browser=browser,
+        home=home,
+        force=force,
+    )
+
+
+def resolve(
+    version: str,
+    *,
+    browser: str = "chromium",
+    home: Path | str | None = None,
+) -> PlaywrightBrowserInstallation:
+    return resolve_playwright_browser(version, browser=browser, home=home)
+
+
+def doctor(
+    installation: PlaywrightBrowserInstallation,
+    *,
+    execute: bool = True,
+) -> dict[str, Any]:
+    return doctor_playwright_browser(installation, execute=execute)
+
+
+__all__ = [
+    "DEFAULT_HOME",
+    "SUPPORTED_BROWSERS",
+    "PlaywrightBrowserInstallation",
+    "PlaywrightError",
+    "doctor",
+    "install",
+    "resolve",
+]

chatup-0.2.5/src/chatup/runtime/__init__.py

@@ -0,0 +1,6 @@
+"""Internal implementations for backend-specific ChatUp artifacts.
+
+Public consumers should import :mod:`chatup.chrome_for_testing`,
+:mod:`chatup.chromedriver`, or :mod:`chatup.playwright` instead of this
+internal package.
+"""