py-wlcli 0.6.14__tar.gz → 0.8.0__tar.gz

py_wlcli-0.8.0/.gitignore

@@ -0,0 +1,116 @@
+# Python 相关文件
+__pycache__/
+*.py[cod]
+*.so
+*.dll
+*.dylib
+*.pyd
+*.egg-info/
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.hypothesis/
+.cache/
+.trae/
+.wl/
+.claude/
+
+# 构建目录
+build/
+dist/
+wheels/
+target/
+
+# 虚拟环境
+.venv/
+env/
+venv/
+ENV/
+
+# Issue #220: `env/` above is a virtualenv pattern, but the env *domain* is
+# repo code. Re-include only the two in-tree paths. `!dir/` must precede
+# `!dir/**`: git cannot re-include files under an excluded parent directory.
+# The trailing __pycache__ rules win over `!dir/**` (last match wins) so
+# bytecode stays ignored inside the re-included trees.
+!src/wl_cli/env/
+!src/wl_cli/env/**
+!tests/domains/env/
+!tests/domains/env/**
+# ...but only source: virtualenvs, bytecode and nested env/venv directories
+# stay ignored anywhere inside those two re-included trees (last match wins).
+src/wl_cli/env/**/__pycache__/
+tests/domains/env/**/__pycache__/
+src/wl_cli/env/**/.venv/
+src/wl_cli/env/**/env/
+src/wl_cli/env/**/venv/
+src/wl_cli/env/**/ENV/
+tests/domains/env/**/.venv/
+tests/domains/env/**/env/
+tests/domains/env/**/venv/
+tests/domains/env/**/ENV/
+
+# 依赖管理
+.uv/
+.uv_cache/
+.ruff_cache/
+.mypy_cache/
+node_modules/
+
+# IDE 和编辑器
+.idea/
+.vscode/
+.vs/
+*.sln
+*.suo
+*.ntvs*
+*.njsproj
+*.sw?
+
+# 临时文件和系统文件
+.DS_Store
+
+# Jupyter 文件
+.ipynb_checkpoints/
+
+# 日志和数据文件
+*.log
+logs/
+results/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+dev-debug.log
+
+# 本地配置
+.env
+.env.local
+# PyPI/twine 凭据文件（历史上曾误入库，见 docs/sop-audit/2026-10-04-sop-report.md F7）
+.pypirc
+auto_activate_venv.sh
+deactivate_temp.sh
+
+# 工具和脚本（本地使用，不加入版本控制）
+todos/
+
+# 类型与本地生成文件
+typings/
+src/wl_cli/lib/sop.md
+
+# 任务和临时文件
+tasks.json
+tasks/
+**/*.token
+
+# Git worktree 和测试工具
+.worktrees/
+.rpytest/flakiness.json
+
+# agent 工具链的本地状态（每次运行都会重建，不进版本控制）
+.codex/
+.loopx/
+
+# 一致性语料（票 #273）：语料归需求方（wlcc），按 contract-v1 克隆取用，永不入库。
+# CI 的 contract job 克隆到 .contract-corpus/；本地按需克隆到 tests/contract/。
+.contract-corpus/
+tests/contract/

{py_wlcli-0.6.14 → py_wlcli-0.8.0}/PKG-INFO

@@ -1,40 +1,41 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: py_wlcli
-Version: 0.6.14
-Requires-Dist: toml>=0.10.2
+Version: 0.8.0
+Summary: wl_cli - Python项目
+Project-URL: Homepage, https://gitlab.gewinnrobo.com/Humuyuan/wl-cli
+Project-URL: Issues, https://gitlab.gewinnrobo.com/Humuyuan/wl-cli/-/issues
+Author-email: WL Admin <wl.admin@example.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
 Requires-Dist: click>=8.1.0
-Requires-Dist: tqdm>=4.66.0
 Requires-Dist: pre-commit>=4.5.1
-Requires-Dist: mypy>=1.18.2 ; extra == 'dev'
-Requires-Dist: ruff==0.15.21 ; extra == 'dev'
-Requires-Dist: types-toml>=0.10.8.20240310 ; extra == 'dev'
-Requires-Dist: types-tqdm>=4.67.0.20250809 ; extra == 'dev'
-Requires-Dist: pytest-xdist>=3.8.0 ; extra == 'dev'
-Requires-Dist: twine>=6.2.0 ; extra == 'dev'
-Requires-Dist: pyyaml>=6.0.0 ; extra == 'lfs'
-Requires-Dist: watchdog>=6.0.0 ; extra == 'lfs'
-Requires-Dist: pytest>=9.0.3 ; extra == 'test'
-Requires-Dist: pytest-cov>=7.0.0 ; extra == 'test'
-Requires-Dist: pytest-asyncio>=1.3.0 ; extra == 'test'
-Requires-Dist: pyyaml>=6.0.0 ; extra == 'test'
-Requires-Dist: watchdog>=6.0.0 ; extra == 'test'
+Requires-Dist: toml>=0.10.2
+Requires-Dist: tqdm>=4.66.0
 Provides-Extra: dev
+Requires-Dist: mypy>=1.18.2; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.8.0; extra == 'dev'
+Requires-Dist: ruff==0.15.21; extra == 'dev'
+Requires-Dist: twine>=6.2.0; extra == 'dev'
+Requires-Dist: types-toml>=0.10.8.20240310; extra == 'dev'
+Requires-Dist: types-tqdm>=4.67.0.20250809; extra == 'dev'
 Provides-Extra: lfs
+Requires-Dist: pyyaml>=6.0.0; extra == 'lfs'
+Requires-Dist: watchdog>=6.0.0; extra == 'lfs'
 Provides-Extra: test
-License-File: LICENSE
-Summary: wl_cli - Python项目
-Author-email: WL Admin <wl.admin@example.com>
-License-Expression: MIT
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Homepage, https://gitlab.gewinnrobo.com/Humuyuan/wl-cli
-Project-URL: Issues, https://gitlab.gewinnrobo.com/Humuyuan/wl-cli/-/issues
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'test'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'test'
+Requires-Dist: pytest>=9.0.3; extra == 'test'
+Requires-Dist: pyyaml>=6.0.0; extra == 'test'
+Requires-Dist: watchdog>=6.0.0; extra == 'test'
+Description-Content-Type: text/markdown
 
 # wl_cli（`wl` CLI）
 
-`wl_cli` 是一个 Python + Rust 混合的命令行工具，命令入口为 `wl`。它以 Click 构建 CLI，
-以 maturin + pyo3 编译 Rust 原生扩展，面向 Python 项目的初始化、构建、测试、格式化、lint、
-清理与质量门等日常开发工作流。
+`wl_cli` 是一个以 Click 构建的命令行工具（入口 `wl`），面向 Python 项目的初始化、构建、
+测试、格式化、lint、清理与质量门等日常开发工作流。发行物是纯 Python wheel
+（`py3-none-any`），安装与运行都不需要 Rust 工具链；Rust 扩展是可选的诊断件，
+缺失时自动回落纯 Python 实现。
 
 ## 功能概览
 
@@ -54,10 +55,23 @@ Project-URL: Issues, https://gitlab.gewinnrobo.com/Humuyuan/wl-cli/-/issues
 
 ## 环境要求
 
-- Python >= 3.11
-- 从源码构建 Rust 扩展时需要 Rust 工具链（maturin/pyo3）
+- Python >= 3.11（纯 Python 路径，安装与运行都不需要 Rust/cargo）
 - 包管理器推荐 [uv](https://docs.astral.sh/uv/)
 
+### 平台支持矩阵
+
+| 平台 | 架构 | 支持 |
+|------|------|------|
+| macOS | x86_64 / arm64 | ✅ |
+| Linux（glibc） | x86_64 / aarch64 | ✅ |
+| Linux（musl） | x86_64 / aarch64 | ✅ |
+| Windows | x64 / arm64 | ✅ |
+
+同一个 `py3-none-any` wheel 覆盖以上全部平台。平台报告由
+`wl_cli.platform.platform_payload()` 统一产出
+（`platform` / `python` / `native_extension` / `supported` / `reason`），
+其中 `native_extension` 只作诊断——Rust 扩展可选，缺失不影响 `supported`。
+
 ## 安装
 
 ### 稳定版（PyPI）
@@ -115,12 +129,11 @@ pytest tests/ -v     # 指定文件（pytest 直跑）
 ## 架构速览
 
 Click CLI（[src/wl_cli/cli_click.py](https://github.com/CharlieZi/wl-cli/blob/main/src/wl_cli/cli_click.py)
-经 `setup_commands()` 直接注册）→ 各命令实现（`commands/<group>/`）→ 业务逻辑；
-Rust 原生扩展（`rust/`、`src/wl_cli/lib/`）经 maturin 编译为 `wl_cli_native`；
-依赖注入容器集中管理共享服务（`infrastructure/dependency_injection.py`）。
+经 `setup_commands()` 直接注册）→ 各命令实现（`commands/<group>/`）→ 业务逻辑。
+Rust 扩展是可选的诊断件：`src/wl_cli/lib/rust_utils.py` 在 `wl_cli_native`
+不可用时回落纯 Python；发行 wheel 不包含任何原生二进制。
 架构演进背景见 [Click 迁移设计](https://github.com/CharlieZi/wl-cli/blob/main/docs/superpowers/specs/2026-06-02-full-click-migration-design.md)。
 
 ## 许可证
 
 MIT，见 [LICENSE](https://github.com/CharlieZi/wl-cli/blob/main/LICENSE)。
-

{py_wlcli-0.6.14 → py_wlcli-0.8.0}/README.md

@@ -1,8 +1,9 @@
 # wl_cli（`wl` CLI）
 
-`wl_cli` 是一个 Python + Rust 混合的命令行工具，命令入口为 `wl`。它以 Click 构建 CLI，
-以 maturin + pyo3 编译 Rust 原生扩展，面向 Python 项目的初始化、构建、测试、格式化、lint、
-清理与质量门等日常开发工作流。
+`wl_cli` 是一个以 Click 构建的命令行工具（入口 `wl`），面向 Python 项目的初始化、构建、
+测试、格式化、lint、清理与质量门等日常开发工作流。发行物是纯 Python wheel
+（`py3-none-any`），安装与运行都不需要 Rust 工具链；Rust 扩展是可选的诊断件，
+缺失时自动回落纯 Python 实现。
 
 ## 功能概览
 
@@ -22,10 +23,23 @@
 
 ## 环境要求
 
-- Python >= 3.11
-- 从源码构建 Rust 扩展时需要 Rust 工具链（maturin/pyo3）
+- Python >= 3.11（纯 Python 路径，安装与运行都不需要 Rust/cargo）
 - 包管理器推荐 [uv](https://docs.astral.sh/uv/)
 
+### 平台支持矩阵
+
+| 平台 | 架构 | 支持 |
+|------|------|------|
+| macOS | x86_64 / arm64 | ✅ |
+| Linux（glibc） | x86_64 / aarch64 | ✅ |
+| Linux（musl） | x86_64 / aarch64 | ✅ |
+| Windows | x64 / arm64 | ✅ |
+
+同一个 `py3-none-any` wheel 覆盖以上全部平台。平台报告由
+`wl_cli.platform.platform_payload()` 统一产出
+（`platform` / `python` / `native_extension` / `supported` / `reason`），
+其中 `native_extension` 只作诊断——Rust 扩展可选，缺失不影响 `supported`。
+
 ## 安装
 
 ### 稳定版（PyPI）
@@ -83,9 +97,9 @@ pytest tests/ -v     # 指定文件（pytest 直跑）
 ## 架构速览
 
 Click CLI（[src/wl_cli/cli_click.py](https://github.com/CharlieZi/wl-cli/blob/main/src/wl_cli/cli_click.py)
-经 `setup_commands()` 直接注册）→ 各命令实现（`commands/<group>/`）→ 业务逻辑；
-Rust 原生扩展（`rust/`、`src/wl_cli/lib/`）经 maturin 编译为 `wl_cli_native`；
-依赖注入容器集中管理共享服务（`infrastructure/dependency_injection.py`）。
+经 `setup_commands()` 直接注册）→ 各命令实现（`commands/<group>/`）→ 业务逻辑。
+Rust 扩展是可选的诊断件：`src/wl_cli/lib/rust_utils.py` 在 `wl_cli_native`
+不可用时回落纯 Python；发行 wheel 不包含任何原生二进制。
 架构演进背景见 [Click 迁移设计](https://github.com/CharlieZi/wl-cli/blob/main/docs/superpowers/specs/2026-06-02-full-click-migration-design.md)。
 
 ## 许可证

py_wlcli-0.8.0/VERSION

@@ -0,0 +1 @@
+0.8.0

{py_wlcli-0.6.14 → py_wlcli-0.8.0}/pyproject.toml

@@ -43,57 +43,62 @@ lfs = [
 url = "https://pypi.mirrors.ustc.edu.cn/simple"
 default = true
 
+# Issue #226 / wlcc #321: the distribution is a pure-Python wheel
+# (`py3-none-any`); installing it needs no Rust toolchain. VERSION stays the
+# single source of truth and hatchling reads it directly.
 [build-system]
-requires = [ "maturin>=1.0,<2.0",]
-build-backend = "maturin"
+requires = [ "hatchling>=1.27",]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "regex"
+path = "VERSION"
+pattern = '(?P<version>\d+\.\d+\.\d+)'
+
+[tool.hatch.build.targets.wheel]
+packages = [ "src/wl_cli",]
+# Runtime templates under vendors/ must ship inside the wheel (`wl init` copies
+# them). Native artefacts are never part of a pure-Python wheel, even if one is
+# left in the tree by an older local build.
+exclude = [
+  "**/*.so",
+  "**/*.pyd",
+  "**/*.dll",
+  "**/*.dylib",
+]
 
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/VERSION",
+  "/LICENSE",
+  "/README.md",
+  "/pyproject.toml",
+]
 
 [project.urls]
 Homepage = "https://gitlab.gewinnrobo.com/Humuyuan/wl-cli"
 Issues = "https://gitlab.gewinnrobo.com/Humuyuan/wl-cli/-/issues"
 
-[tool.maturin]
-manifest-path = "rust/Cargo.toml"
-module-name = "wl_cli.lib.wl_cli_native"
-python-source = "src"
-include = [
-  "src/wl_cli/**/*",
-  "typings/**/*",
-  "LICENSE",
-]
-bindings = "pyo3"
-# 与 rust/Cargo.toml 的 pyo3 features 保持同步（lockstep）：maturin 将此处特性作为 --features
-# 透传给 cargo，与 Cargo.toml 取并集，任一处即可生效；两处必须一致。
-# Keep in lockstep with pyo3.features in rust/Cargo.toml — maturin forwards these to
-# cargo as --features, unioned with the Cargo.toml features; both must match.
-features = [
-  "pyo3/extension-module",
-  "pyo3/abi3",
-  "pyo3/abi3-py311",
-  "pyo3/generate-import-lib",
-]
-sdist-include = [
-  "src/**/*",
-  "typings/**/*",
-  "VERSION",
-  "LICENSE",
-]
-sdist-exclude = [
-  "src/wl_cli/vendors/**/*",
-]
-python-packages = [ "wl_cli",]
-
 [tool.ruff]
 line-length = 88
 target-version = "py310"
 
 [tool.ruff.format]
 preview = false
+# Vendored upstream assets are not this repo's code, so they must never redden
+# the format leg -- same 口径 as the existing codespell exclusion
+# (^src/wl_cli/vendors/ in .wl/.pre-commit-config.yaml). `lint` and `format`
+# keep separate exclude lists, so the pattern is written in both; the dual
+# assertion in tests/test_gate_lint_scope.py pins both legs so neither can be
+# silently widened. The glob needs `/**` (ruff matches file paths, so a bare
+# directory path matches nothing).
+exclude = [ "src/wl_cli/vendors/**",]
 
 [tool.ruff.lint]
 select = ["E", "W", "F", "I", "C4", "UP", "N", "B", "C90", "TCH"]
 ignore = ["E501", "B904", "E402", "F811", "S607", "N802", "N817"]
-exclude = [ ".git", ".ruff_cache", "__pycache__", "build", "dist", "*.egg-info", "uv.lock", "tmp",]
+exclude = [ ".git", ".ruff_cache", "__pycache__", "build", "dist", "*.egg-info", "uv.lock", "tmp", "src/wl_cli/vendors/**",]
 
 # F841 (unused local variable) is enabled for package code as a dead-code
 # backstop, but exempted in tests where unused locals are often scaffolding.

{py_wlcli-0.6.14 → py_wlcli-0.8.0}/src/wl_cli/__main__.py

@@ -16,7 +16,14 @@ def _setup_stdio_encoding() -> None:
     characters crash print(). This wraps stdout/stderr with explicit
     UTF-8 encoding so all output works regardless of terminal locale.
     """
-    if not sys.platform.startswith("win"):
+    # Imported here (with a script-execution fallback, matching the cli_click
+    # import below) so this module stays runnable as a plain script.
+    try:
+        from .utils import platform_adapter
+    except ImportError:  # pragma: no cover - direct script execution
+        from wl_cli.utils import platform_adapter  # type: ignore[no-redef]
+
+    if not platform_adapter.PlatformAdapter.is_windows():
         return
     # PYTHONIOENCODING also helps subprocess pipe encoding
     os.environ.setdefault("PYTHONIOENCODING", "utf-8")
@@ -105,8 +112,14 @@ except ImportError:
 
 
 def main() -> None:
-    """Main entry point for WL Commands."""
-    cli_main()
+    """Main entry point for WL Commands.
+
+    ``cli_click.main`` returns the process exit code (0 on success, 1 when a
+    command raises), so the entry point must hand that value to the
+    interpreter instead of discarding it. Without the ``SystemExit`` every
+    ``return 1`` path inside ``cli_click.main`` exited 0 (#186).
+    """
+    raise SystemExit(cli_main())
 
 
 # Alias for compatibility with tests

py_wlcli-0.8.0/src/wl_cli/capabilities.py

@@ -0,0 +1,79 @@
+"""The shared capability registry for the ``wl`` CLI (issues #270, #221).
+
+Capabilities are the stable, dotted names a consumer (wlcc) probes instead of
+grepping ``--help`` for an implementation flag (wlcc ADR-0010, decision 6):
+``test.clean_cache`` says *what wl can do*; ``--clean-cache`` is only how it is
+spelled today. The dotted names are the interface -- treat them as stable.
+
+The registry lives in the shared layer rather than under ``wl_cli.env`` or
+``wl_cli.commands`` because two commands in different domains must serve the
+same names: ``wl env check`` (``wl_cli.env``) and the deprecated
+``wl self capabilities`` alias (``wl_cli.commands``). The quality domain may
+not import the env domain (#220), so one shared data owner is the only
+arrangement that does not fork the answer.
+
+Adding a capability is a data change here plus an entry in the surface table
+of ``tests/test_self_capabilities_270.py`` proving some CLI surface still
+backs it, so a name cannot outlive its implementation.
+
+A domain may keep a domain-local view of its own entries
+(``wl_cli.mcp.capabilities.CAPABILITIES``, #224) derived from this mapping;
+the data itself lives here only, and ``tests/test_capability_registry.py``
+pins that the view cannot drift.
+"""
+
+from __future__ import annotations
+
+#: Bump only when the payload *shape* changes -- never when a capability is
+#: added. Consumers key off this; adding a capability is backwards compatible.
+SCHEMA_VERSION = 1
+
+#: Capability name -> first release that ships its implementation. Adding an
+#: entry is a data change; ``since`` must never be newer than the release this
+#: data ships in (the release bump happens outside this change).
+CAPABILITY_SINCE: dict[str, str] = {
+    "cc.check": "0.8.0",
+    "cc.hooks": "0.8.0",
+    "cc.init": "0.8.0",
+    "cc.mcp": "0.8.0",
+    "cc.plugins": "0.8.0",
+    "cc.repair": "0.8.0",
+    "cc.settings": "0.8.0",
+    "cc.stamps": "0.8.0",
+    "cc.statusline": "0.8.0",
+    "cc.upgrade": "0.8.0",
+    "env.check": "0.8.0",
+    "env.repair": "0.8.0",
+    "mcp.gitlab": "0.8.0",
+    "mcp.k8s": "0.8.0",
+    "test.clean_cache": "0.7.0",
+}
+
+#: The advertised names, sorted for stable output. Derived from the mapping so
+#: there is exactly one source of truth.
+CAPABILITIES: tuple[str, ...] = tuple(sorted(CAPABILITY_SINCE))
+
+
+def capability_names() -> list[str]:
+    """Return the advertised capability names, sorted for stable output."""
+    return list(CAPABILITIES)
+
+
+def capability_details() -> list[dict[str, str]]:
+    """Return ``[{"name": ..., "since": ...}, ...]`` in sorted-name order."""
+    return [{"name": name, "since": CAPABILITY_SINCE[name]} for name in CAPABILITIES]
+
+
+def capability_since() -> dict[str, str]:
+    """Return ``{name: since}`` in sorted-name order."""
+    return {name: CAPABILITY_SINCE[name] for name in CAPABILITIES}
+
+
+def capabilities_payload() -> dict[str, object]:
+    """Return the legacy ``wl self capabilities --json`` payload (#270).
+
+    ``wl self capabilities`` is a deprecated alias since #221 and emits the
+    ``wl env check`` envelope instead, but the old shape stays importable so a
+    library consumer does not break in the same release that deprecates it.
+    """
+    return {"schema": SCHEMA_VERSION, "capabilities": capability_names()}

py_wlcli-0.8.0/src/wl_cli/cc/__init__.py

@@ -0,0 +1,5 @@
+"""Claude Code integration domain (may depend on ``wl_cli.env``, never the reverse)."""
+
+from .cli import cc_group
+
+__all__ = ["cc_group"]