scriptnow-cli 0.3.94__py3-none-any.whl

cli_anything/scriptnow/utils/upgrade.py

@@ -0,0 +1,331 @@
+"""Version check and self-upgrade for scriptnow-cli.
+
+The CLI checks for a newer version on the public GitHub repo
+(quchenchen/scriptnow-cli — the release mirror of this monorepo) at low
+frequency (once per 24h, cached locally, silent on failure) and offers
+`scriptnow self-upgrade` to apply the update after explicit user consent.
+"""
+
+from __future__ import annotations
+
+import json
+import importlib.util
+import os
+import shutil
+import subprocess
+import sys
+import threading
+import time
+from pathlib import Path
+
+import requests
+
+from cli_anything.scriptnow import __version__ as VERSION
+
+_REMOTE_INIT = (
+    "https://raw.githubusercontent.com/quchenchen/scriptnow-cli/main/"
+    "cli_anything/scriptnow/__init__.py"
+)
+# 生产源：sn.igeewa.com 托管 CLI wheel / zip / version.txt，作为自动更新的优先来源
+# （直装 wheel，避免 git 部分克隆被网络掐断；GitHub 仅作版本与下载兜底）。
+_REMOTE_VERSION_TXT = "https://sn.igeewa.com/downloads/scriptnow-cli/version.txt"
+_PROD_WHEEL_TMPL = (
+    "https://sn.igeewa.com/downloads/scriptnow-cli/scriptnow_cli-{version}-py3-none-any.whl"
+)
+_CHECK_INTERVAL_SECONDS = 24 * 60 * 60
+
+
+def _version_tuple(value: str) -> tuple[int, int, int] | None:
+    parts = value.strip().split(".")
+    if len(parts) != 3 or not all(part.isdigit() for part in parts):
+        return None
+    return tuple(int(part) for part in parts)  # type: ignore[return-value]
+
+
+def is_newer_version(candidate: str, current: str = VERSION) -> bool:
+    candidate_tuple = _version_tuple(candidate)
+    current_tuple = _version_tuple(current)
+    return bool(
+        candidate_tuple is not None
+        and current_tuple is not None
+        and candidate_tuple > current_tuple
+    )
+
+
+def _state_path() -> Path:
+    override = os.environ.get("SCRIPTNOW_CLI_CONFIG")
+    root = Path(override).parent if override else Path(
+        os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config"))
+    ) / "scriptnow-cli"
+    return root / "version-check.json"
+
+
+def _config_path() -> Path:
+    override = os.environ.get("SCRIPTNOW_CLI_CONFIG")
+    root = Path(override).parent if override else Path(
+        os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config"))
+    ) / "scriptnow-cli"
+    return root / "config.json"
+
+
+def load_config() -> dict[str, object]:
+    """Read the CLI config file. Missing/corrupt → defaults."""
+    try:
+        data = json.loads(_config_path().read_text(encoding="utf-8"))
+        if isinstance(data, dict):
+            return data
+    except (OSError, ValueError):
+        pass
+    return {}
+
+
+def set_config(**updates: object) -> dict[str, object]:
+    """Persist config, preserving unknown keys."""
+    config = load_config()
+    config.update(updates)
+    try:
+        path = _config_path()
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps(config, ensure_ascii=False, indent=2))
+    except OSError:
+        raise
+    return config
+
+
+def auto_upgrade_enabled() -> bool:
+    return bool(load_config().get("autoUpgrade", False))
+
+
+def _fetch_production_version(timeout: int) -> str | None:
+    """Read version.txt hosted on the production download host (preferred)."""
+    try:
+        response = requests.get(_REMOTE_VERSION_TXT, timeout=timeout)
+        if response.status_code != 200:
+            return None
+        version = response.text.strip()
+        if version and all(part.isdigit() for part in version.split(".")[:2]):
+            return version
+    except requests.RequestException:
+        return None
+    return None
+
+
+def _fetch_github_version(timeout: int) -> str | None:
+    """Query the GitHub release mirror for the newest __version__ (fallback)."""
+    try:
+        response = requests.get(_REMOTE_INIT, timeout=timeout)
+        if response.status_code != 200:
+            return None
+        for line in response.text.splitlines():
+            line = line.strip()
+            if line.startswith("__version__"):
+                parts = line.split('"')
+                if len(parts) >= 2 and parts[1]:
+                    return parts[1]
+    except requests.RequestException:
+        return None
+    return None
+
+
+def latest_version(timeout: int = 8) -> str | None:
+    """Return the newest CLI version — production host first, GitHub fallback.
+
+    Returns None when all sources fail or the remote version cannot be parsed;
+    the caller treats that as "no information" and stays silent.
+    """
+    version = _fetch_production_version(timeout)
+    if version:
+        return version
+    return _fetch_github_version(timeout)
+
+
+def _is_stale() -> bool:
+    try:
+        state = json.loads(_state_path().read_text(encoding="utf-8"))
+        return float(state.get("checked_at") or 0) + _CHECK_INTERVAL_SECONDS < time.time()
+    except (OSError, ValueError, KeyError):
+        return True
+
+
+def _record_check() -> None:
+    try:
+        path = _state_path()
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps({"checked_at": int(time.time())}))
+    except OSError:
+        pass
+
+
+def check_for_update(force: bool = False) -> str | None:
+    """Return the latest version when a newer one exists, else None.
+
+    Non-blocking for the caller: network happens in this function with a
+    short timeout; the 24h cache avoids a request on every invocation.
+    """
+    if not force and not _is_stale():
+        return None
+    latest = latest_version()
+    _record_check()
+    if latest is None or not is_newer_version(latest):
+        return None
+    return latest
+
+
+def _environment_install_command(
+    source: str, *, upgrade_only: bool = False
+) -> tuple[str, list[str]] | None:
+    """Install into the interpreter that is running this CLI.
+
+    Virtual environments must never receive ``--user``. A base interpreter may
+    need a user install; ``--break-system-packages`` is POSIX-only. If a uv-made
+    environment has no pip module, target it explicitly through ``uv pip``.
+    """
+    action = "--upgrade" if upgrade_only else "--force-reinstall"
+    if importlib.util.find_spec("pip") is not None:
+        flags: list[str] = []
+        if sys.prefix == getattr(sys, "base_prefix", sys.prefix):
+            flags.append("--user")
+            if os.name != "nt":
+                flags.append("--break-system-packages")
+        return sys.executable, ["-m", "pip", "install", *flags, action, source]
+    if shutil.which("uv"):
+        return "uv", ["pip", "install", "--python", sys.executable, action, source]
+    return None
+
+
+def _install_command(version: str | None = None) -> tuple[str, list[str]] | None:
+    """Resolve an upgrade command for the current installed environment."""
+    try:
+        import importlib.metadata as md
+
+        dist = md.distribution("scriptnow-cli")
+    except md.PackageNotFoundError:
+        return None
+    # Editable install (local dev): can't self-upgrade blindly — tell the user.
+    for file in dist.files or []:
+        if "__editable__" in str(file):
+            return None
+    source = (
+        _PROD_WHEEL_TMPL.format(version=version)
+        if version
+        else "https://codeload.github.com/quchenchen/scriptnow-cli/tar.gz/refs/heads/main"
+    )
+    return _environment_install_command(source)
+
+
+def is_editable_install() -> bool:
+    try:
+        import importlib.metadata as md
+
+        dist = md.distribution("scriptnow-cli")
+    except md.PackageNotFoundError:
+        return False
+    return any("__editable__" in str(file) for file in (dist.files or []))
+
+
+def _upgrade_fallback() -> tuple[str, list[str]] | None:
+    """备选升级命令：git+https（当 codeload 被拦时）。"""
+    return _environment_install_command(
+        "git+https://github.com/quchenchen/scriptnow-cli.git", upgrade_only=True
+    )
+
+
+def upgrade(quiet: bool = False) -> bool:
+    """Apply the upgrade. Returns True on success.
+
+    Attempts sources in priority order: production wheel (sn.igeewa.com) →
+    codeload tar.gz (GitHub) → git+https (last resort)."""
+    latest = latest_version()
+    if latest is not None and not is_newer_version(latest) and latest != VERSION:
+        return True  # Never downgrade a newer local/dev build to an older feed.
+    if is_editable_install():
+        target = latest or VERSION
+        candidate = _environment_install_command(
+            _PROD_WHEEL_TMPL.format(version=target)
+        )
+        if candidate is None:
+            if not quiet:
+                print("当前 Python 环境无 pip 且未找到 uv，无法自动升级。")
+            return False
+        result = subprocess.run(
+            [candidate[0], *candidate[1]],
+            capture_output=True,
+            text=True,
+            timeout=300,
+        )
+        if result.returncode == 0:
+            return True
+        if not quiet:
+            print((result.stderr or "同版本补丁刷新失败。")[-500:])
+        return False
+    attempts: list[tuple[str, list[str]] | None] = []
+    if latest:
+        attempts.append(_install_command(latest))  # 生产源 wheel
+    attempts.append(_install_command())            # codeload main 兜底
+    attempts.append(_upgrade_fallback())           # git+https 最后兜底
+    last_stderr = ""
+    for candidate in attempts:
+        if not candidate:
+            continue
+        cmd = [candidate[0], *candidate[1]]
+        result = subprocess.run(cmd, capture_output=True, text=True, timeout=300)
+        if result.returncode == 0:
+            return True
+        last_stderr = result.stderr or ""
+    if not quiet:
+        print(last_stderr[-500:] or "升级失败。")
+    return False
+
+
+def maybe_warn_in_background() -> None:
+    """Spawn a non-blocking background version check.
+
+    Default behaviour: print a one-line hint when a newer version exists.
+
+    When the user has opted into ``autoUpgrade`` (``scriptnow config
+    auto-upgrade on``), the background check instead attempts the upgrade
+    automatically and notifies the user before/after — never blocking the
+    main command. Editable/dev installs are never auto-upgraded.
+    """
+    import sys
+
+    def _run() -> None:
+        try:
+            latest = check_for_update()
+            if not latest:
+                return
+            if auto_upgrade_enabled():
+                if _install_command() is None:
+                    # Editable/dev install: never auto-upgrade; fall back to a
+                    # normal hint so the user knows a newer version exists.
+                    print(
+                        f"发现 ScriptNow CLI 新版本 v{latest}（当前 v{VERSION}）。"
+                        f"本地为开发安装，请手动升级。",
+                        file=sys.stderr,
+                    )
+                    return
+                print(
+                    f"[scriptnow] 检测到新版本 v{latest}（当前 v{VERSION}），正在自动升级…",
+                    file=sys.stderr,
+                )
+                ok = upgrade(quiet=False)
+                if ok:
+                    print(
+                        f"[scriptnow] 已自动升级到 v{latest}。请重新运行 scriptnow 使新版本生效。",
+                        file=sys.stderr,
+                    )
+                else:
+                    print(
+                        "[scriptnow] 自动升级未完成，请运行 `scriptnow self-upgrade` 手动升级。",
+                        file=sys.stderr,
+                    )
+                return
+            print(
+                f"发现 ScriptNow CLI 新版本 v{latest}（当前 v{VERSION}）。"
+                f"运行 `scriptnow self-upgrade` 自动升级，或 `scriptnow version --check` 查看。",
+                file=sys.stderr,
+            )
+        except Exception:
+            pass  # never break the main command because of a version hint
+
+    threading.Thread(target=_run, daemon=True).start()

scriptnow_cli-0.3.94.dist-info/METADATA

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: scriptnow-cli
+Version: 0.3.94
+Summary: ScriptNow 创作 CLI —— 从灵感到成书交付的一站式命令行（CLI-Anything 模式）
+Author: ScriptNow
+License: MIT
+Project-URL: Homepage, https://sn.igeewa.com
+Project-URL: Documentation, https://sn.igeewa.com/cli
+Project-URL: Repository, https://github.com/quchenchen/scriptnow-cli
+Project-URL: Issues, https://github.com/quchenchen/scriptnow-cli/issues
+Keywords: scriptnow,novel,script,cli,agent,cli-anything
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.28
+Dynamic: license-file
+Dynamic: requires-python
+
+# ScriptNow CLI
+
+An agent-friendly command-line client for the [ScriptNow](https://sn.igeewa.com)
+creative writing platform. Authors and screenwriters can work with an AI agent
+to develop projects, review planning candidates, write chapters or scenes, and
+export their work.
+
+## Install
+
+Requires Python 3.10 or later. Use a virtual environment or a CLI tool installer:
+
+```sh
+pipx install scriptnow-cli
+# Alternatively, inside a virtual environment:
+python -m pip install scriptnow-cli
+```
+
+The command is `scriptnow`; the distribution name is `scriptnow-cli`.
+
+## Get started
+
+```sh
+scriptnow --version
+scriptnow agent-guide --json
+scriptnow doctor
+scriptnow login --host https://sn.igeewa.com --email you@example.com
+scriptnow guide --medium novel
+# For screenwriting:
+scriptnow guide --medium script
+```
+
+Enter your password at the hidden terminal prompt. A ScriptNow account and
+appropriate project access are required; installing this client does not create
+an account or grant service credits.
+
+## For AI agents
+
+Always read `scriptnow agent-guide --json` before operating the platform. Use
+the current command's `--help` for arguments and schemas. Read platform state
+before writes and read it back after success. Do not invent project IDs or
+treat local drafts as saved platform content.
+
+- Create each author's own project and retain the ID returned by the platform.
+- Co-create planning locally, submit candidates through the appropriate
+  `propose` commands, and obtain the author's explicit decision before adoption.
+- Follow direction, story core, blueprint, synopsis, rough outline, chapter or
+  episode outlines, then prose. Check planning quality and writing readiness.
+- By default, invoke the platform's writing agent for chapters and scenes.
+  Follow the returned run ID; do not repeatedly start the same generation.
+- Show complete candidate content and record the human's actual decision using
+  the current review protocol. Never infer adoption from silence.
+
+Novels and scripts use separate domain commands and formats. The platform is
+the source of truth for adopted content and continuity.
+
+## Distribution and updates
+
+The platform also distributes versioned wheels and Windows installers at
+[its download host](https://sn.igeewa.com/downloads/scriptnow-cli/).
+`scriptnow self-upgrade` checks the platform distribution first; GitHub is a
+fallback. PyPI releases may appear on a different schedule. Automatic updates
+are opt-in with `scriptnow config on`.
+
+See the [full CLI documentation](https://github.com/quchenchen/scriptnow-cli#readme)
+and [platform guide](https://sn.igeewa.com/cli). Licensed under MIT.

scriptnow_cli-0.3.94.dist-info/RECORD

@@ -0,0 +1,17 @@
+cli_anything/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli_anything/scriptnow/README.md,sha256=OBSwDAVHHl-25Po9HxsEUsWdZGsYofshzQytO6vBGzw,30270
+cli_anything/scriptnow/__init__.py,sha256=6JRriDERwvidfcaumV2DT6siP0TAadgDb8r6tcy20UA,102
+cli_anything/scriptnow/__main__.py,sha256=TFNjbBI8UK64s6E1mvCATanTOKPwxr9038L9u8HAoYk,147
+cli_anything/scriptnow/scriptnow_cli.py,sha256=ABwcNFwmGjrL-tEdZOvecB7ain9G_wZO7Oc-syp_cVM,532182
+cli_anything/scriptnow/ui.py,sha256=kVl7O0sg65YJTL1MCzwX1WTT2zivCoLVrbyA-Irrqpg,4982
+cli_anything/scriptnow/skills/SKILL.md,sha256=p_lbTcakQKvKdZHuhcbpQkHCFHtbL9zYLQ8cjS825Vg,23696
+cli_anything/scriptnow/utils/__init__.py,sha256=pFMGHVnbNf7ROI_ERG9lRSEdlyvfLBvJI1UOeKUGDyE,54
+cli_anything/scriptnow/utils/diag.py,sha256=h_m3NFL-Vy35ALVs9tAUS4UjbthqqN0cjnQsr21Sw-Y,5238
+cli_anything/scriptnow/utils/session.py,sha256=MUJGswWMpVeL4cyAqS87VPJCHTB9rCAuQcBWzV6Arrc,22014
+cli_anything/scriptnow/utils/upgrade.py,sha256=NyM-L0B_w2tfrp6Jznk53HFPBbMrvoulUCGO2jBOzPY,11861
+scriptnow_cli-0.3.94.dist-info/licenses/LICENSE,sha256=1p07s14BpEHskGKRoVRrNWSjCCaN6QQx1pGSRtNIQ9w,1066
+scriptnow_cli-0.3.94.dist-info/METADATA,sha256=qxrxZ-DnTGQV4jn3aOgY6qr_IsbU0DtXTyoJqS7O7Vs,3491
+scriptnow_cli-0.3.94.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+scriptnow_cli-0.3.94.dist-info/entry_points.txt,sha256=b_T8LoAoitfuSI2-8x-taBd7Umklo1n5s4GF-1t-MLI,72
+scriptnow_cli-0.3.94.dist-info/top_level.txt,sha256=LI1GTe19xehXrxQtg-3ltETALXYkoctC4Y_iuDiCSRo,13
+scriptnow_cli-0.3.94.dist-info/RECORD,,

scriptnow_cli-0.3.94.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

scriptnow_cli-0.3.94.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+scriptnow = cli_anything.scriptnow.scriptnow_cli:main

scriptnow_cli-0.3.94.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ScriptNow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

scriptnow_cli-0.3.94.dist-info/top_level.txt

@@ -0,0 +1 @@
+cli_anything