vmware-debug 2.3.0__tar.gz → 2.3.1__tar.gz

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "vmware-debug",
   "displayName": "VMware Debug",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "VMware incident timeline, root-cause routing, local case ledger; no vSphere access. 14 MCP tools.",
   "author": {
     "name": "Wei Zhou",

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/.mcp.json

@@ -5,7 +5,7 @@
       "command": "uvx",
       "args": [
         "--from",
-        "vmware-debug==2.3.0",
+        "vmware-debug==2.3.1",
         "vmware-debug-mcp"
       ]
     }

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.5
 Name: vmware-debug
-Version: 2.3.0
+Version: 2.3.1
 Summary: VMware diagnostic brain — offline incident triage, log/event correlation, and root-cause routing across the VMware skill family
 Project-URL: Homepage, https://github.com/vmware-skills/VMware-Debug
 Project-URL: Repository, https://github.com/vmware-skills/VMware-Debug
 Project-URL: Issues, https://github.com/vmware-skills/VMware-Debug/issues
 Project-URL: Changelog, https://github.com/vmware-skills/VMware-Debug/blob/main/RELEASE_NOTES.md
-Author-email: Wei Zhou <wei-wz.zhou@broadcom.com>
+Author-email: Wei Zhou <zhouwei008@gmail.com>
 License-Expression: MIT
 Keywords: ai-ops,debug,diagnostics,mcp,rca,troubleshooting,vmware,vsphere
 Classifier: Development Status :: 4 - Beta
@@ -14,7 +14,8 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: System :: Monitoring
 Requires-Python: >=3.10
-Requires-Dist: mcp[cli]<2.0,>=1.28
+Requires-Dist: certifi>=2026.10.19
+Requires-Dist: mcp[cli]<2.0,>=1.30
 Requires-Dist: pyyaml<7.0,>=6.0
 Requires-Dist: rich<15.0,>=13.0
 Requires-Dist: typer<1.0,>=0.12
@@ -25,6 +26,8 @@ Description-Content-Type: text/markdown
 
 # VMware Debug
 
+For a read-only check of this skill with your model and agent host, use the shared [model-fit self-test](https://github.com/vmware-skills/marketplace/blob/main/MODEL_FIT_SELF_TEST.md) in the marketplace root.
+
 > **Disclaimer**: Community-maintained open-source project, **not affiliated with,
 > endorsed by, or sponsored by VMware, Inc. or Broadcom Inc.** "VMware" and
 > "vSphere" are trademarks of Broadcom. Source is publicly auditable under the MIT
@@ -105,6 +108,8 @@ event actually is.
 
 ## Security
 
+CLI policy refusals print the reason and rule, exit with code 1, and retain one `denied` audit row.
+
 Offline and credential-free by construction: it connects to no vCenter/NSX/Aria, has no destructive surface on
 VMware, and holds no secret to leak. The only writes are the local case ledger: evidence, gaps, hypotheses and
 grade history are append-only; `timeline.md` is regenerated from the evidence, and `case.json` holds the current

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/README-CN.md

@@ -2,6 +2,8 @@
 
 # VMware Debug（中文）
 
+要用自己的模型和 Agent 平台进行只读自测，请看 marketplace 根目录的[共享模型适配自测任务](https://github.com/vmware-skills/marketplace/blob/main/MODEL_FIT_SELF_TEST.md)。
+
 > **声明**：本项目为社区维护的开源项目，**与 VMware, Inc. 或 Broadcom Inc. 无任何隶属、
 > 背书或赞助关系。** "VMware"、"vSphere" 为 Broadcom 商标。源码以 MIT 许可证公开可审计。
 
@@ -68,6 +70,8 @@ debug；debug 因此与其它包零运行时依赖。**请把每条事件的 `ev
 
 ## 安全
 
+CLI 被策略拒绝时会显示原因和规则，以退出码 1 结束，并保留一条 `denied` 审计记录。
+
 结构上离线、无凭据：不连任何 vCenter/NSX/Aria，对 VMware 没有可破坏面，也没有秘密可泄露。
 唯一的写入是本地案卷：证据、缺口、假设和等级历史只增不改；`timeline.md` 由证据重新生成，
 `case.json` 保存当前等级和状态。多个写入者同样成立：每次写案卷都要先拿该案卷的锁文件（`.ledger.lock`，

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/README.md

@@ -2,6 +2,8 @@
 
 # VMware Debug
 
+For a read-only check of this skill with your model and agent host, use the shared [model-fit self-test](https://github.com/vmware-skills/marketplace/blob/main/MODEL_FIT_SELF_TEST.md) in the marketplace root.
+
 > **Disclaimer**: Community-maintained open-source project, **not affiliated with,
 > endorsed by, or sponsored by VMware, Inc. or Broadcom Inc.** "VMware" and
 > "vSphere" are trademarks of Broadcom. Source is publicly auditable under the MIT
@@ -82,6 +84,8 @@ event actually is.
 
 ## Security
 
+CLI policy refusals print the reason and rule, exit with code 1, and retain one `denied` audit row.
+
 Offline and credential-free by construction: it connects to no vCenter/NSX/Aria, has no destructive surface on
 VMware, and holds no secret to leak. The only writes are the local case ledger: evidence, gaps, hypotheses and
 grade history are append-only; `timeline.md` is regenerated from the evidence, and `case.json` holds the current

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/RELEASE_NOTES.md

@@ -1,3 +1,12 @@
+## v2.3.1 — readable Policy refusals and dependency security (2026-11-08)
+
+* Update public author/project contact metadata to `zhouwei008@gmail.com`.
+
+### dependency security and sandbox test stability
+* Require certifi 2026.10.19 or later for MCP's HTTP/TLS dependencies (GHSA-6q48-6c7w-9gw2); the lock resolves 2026.10.23.
+* The audit-isolation regression still proves its write reached only the sandbox DB; it skips the production-DB comparison when the host sandbox denies even read-only access to that DB.
+* CLI policy refusals now print their reason and rule without a traceback. The audited wrapper still records exactly one `denied` row before the CLI exits with code 1.
+
 ## v2.3.0 — roles for network callers (HLD §18)
 
 * Declares the role metadata vmware-policy ≥ 1.24.0 needs to apply **roles** to this server over HTTPS
@@ -898,4 +907,4 @@ executes fixes (advisor/executor split, mirroring vmware-harden → vmware-pilot
 ### Notes
 - Read-only by construction; remediation is routed, never executed.
 - `parse_timestamp` rejects implausible/garbage timestamps loudly rather than
-  silently landing at the epoch.
+  silently landing at the epoch.

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/openclaw.plugin.json

@@ -11,7 +11,7 @@
       "command": "uvx",
       "args": [
         "--from",
-        "vmware-debug==2.3.0",
+        "vmware-debug==2.3.1",
         "vmware-debug-mcp"
       ]
     }

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zw008/vmware-debug",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "VMware incident timeline, root-cause routing, local case ledger; no vSphere access. 14 MCP tools.",
   "private": true,
   "license": "MIT",

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vmware-debug"
-version = "2.3.0"
+version = "2.3.1"
 description = "VMware diagnostic brain — offline incident triage, log/event correlation, and root-cause routing across the VMware skill family"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"
-authors = [{ name = "Wei Zhou", email = "wei-wz.zhou@broadcom.com" }]
+authors = [{ name = "Wei Zhou", email = "zhouwei008@gmail.com" }]
 keywords = ["vmware", "vsphere", "debug", "troubleshooting", "diagnostics", "rca", "mcp", "ai-ops"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -20,7 +20,8 @@ classifiers = [
 dependencies = [
     "typer>=0.12,<1.0",
     "rich>=13.0,<15.0",
-    "mcp[cli]>=1.28,<2.0",
+    "mcp[cli]>=1.30,<2.0",
+    "certifi>=2026.10.19",  # GHSA-6q48-6c7w-9gw2 via MCP/httpx
     "vmware-policy>=1.21.0,<2.0",
     # Imported directly by ops/cases/grading.py for the rules file. It has
     # always arrived transitively via vmware-policy; a package should

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/vmware-skills/VMware-Debug",
     "source": "github"
   },
-  "version": "2.3.0",
+  "version": "2.3.1",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "vmware-debug",
-      "version": "2.3.0",
+      "version": "2.3.1",
       "runtimeHint": "uvx",
       "packageArguments": [
         {

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/skills/vmware-debug/SKILL.md

@@ -25,6 +25,8 @@ metadata: {"openclaw":{"requires":{"anyBins":["vmware-debug","uvx"]},"optional":
 
 # VMware Debug
 
+> Self-test: [guide](https://github.com/vmware-skills/marketplace/blob/main/MODEL_FIT_SELF_TEST.md).
+
 > **Disclaimer**: Community-maintained open-source project, **not affiliated with,
 > endorsed by, or sponsored by VMware, Inc. or Broadcom Inc.** "VMware" and "vSphere"
 > are trademarks of Broadcom. Source is publicly auditable under the MIT license.
@@ -51,7 +53,7 @@ write tools touch only the local case ledger.
 ## Quick Install
 
 ```bash
-uv tool install vmware-debug==2.3.0
+uv tool install vmware-debug==2.3.1
 vmware-debug categories          # see what it can diagnose
 ```
 

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/skills/vmware-debug/references/setup-guide.md

@@ -6,7 +6,7 @@ is a pure, offline correlation engine. There is no `config.yaml` and no `.env`.
 ## Install
 
 ```bash
-uv tool install vmware-debug==2.3.0
+uv tool install vmware-debug==2.3.1
 vmware-debug categories      # verify it runs
 ```
 
@@ -15,7 +15,7 @@ vmware-debug categories      # verify it runs
 ```json
 {
   "command": "uvx",
-  "args": ["--from", "vmware-debug==2.3.0", "vmware-debug-mcp"]
+  "args": ["--from", "vmware-debug==2.3.1", "vmware-debug-mcp"]
 }
 ```
 

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/tests/eval/regression/test_audit_isolation.py

@@ -62,6 +62,11 @@ def test_an_audited_write_lands_in_the_sandbox_and_not_in_the_real_db() -> None:
     real_db = REAL_HOME / ".vmware" / "audit.db"
     if not real_db.exists():
         pytest.skip("no production audit database on this machine to check against")
-    with sqlite3.connect(f"file:{real_db}?mode=ro", uri=True) as con:
-        leaked = con.execute("SELECT count(*) FROM audit_log WHERE tool = ?", (marker,)).fetchone()[0]
+    try:
+        with sqlite3.connect(f"file:{real_db}?mode=ro", uri=True) as con:
+            leaked = con.execute("SELECT count(*) FROM audit_log WHERE tool = ?", (marker,)).fetchone()[0]
+    except sqlite3.OperationalError as exc:
+        if "unable to open database file" not in str(exc):
+            raise
+        pytest.skip("production audit DB is inaccessible from this sandbox")
     assert leaked == 0, f"{leaked} row(s) from this test reached {real_db}"

vmware_debug-2.3.1/tests/eval/regression/test_cli_policy_denial.py

@@ -0,0 +1,23 @@
+"""CLI policy denial must remain a denial in audit and be readable by an operator."""
+
+import pytest
+from typer.testing import CliRunner
+
+from vmware_debug.cli import app
+from vmware_policy import cli_guard
+from vmware_policy.policy import PolicyDenied, PolicyResult
+
+
+@pytest.mark.parametrize("args", [["categories"], ["triage"]])
+def test_denied_cli_command_prints_reason_and_records_one_denial(monkeypatch, args):
+    rows = []
+    def deny(*args, **kwargs):
+        raise PolicyDenied(PolicyResult(allowed=False, rule="ops-review", reason="offline checks denied"))
+    monkeypatch.setattr(cli_guard, "guard", deny)
+    monkeypatch.setattr(cli_guard, "audit_call", lambda *a, **kw: rows.append(kw))
+    result = CliRunner().invoke(app, args, input="[]")
+    assert result.exit_code == 1
+    assert "Denied by policy" in result.output
+    assert "offline checks denied" in result.output and "ops-review" in result.output
+    assert "Traceback" not in result.output
+    assert len(rows) == 1 and rows[0]["status"] == "denied"

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/uv.lock

@@ -1,12 +1,12 @@
 version = 1
-revision = 3
+revision = 5
 requires-python = ">=3.10"
 resolution-markers = [
     "python_full_version >= '3.14' and sys_platform == 'win32'",
     "python_full_version >= '3.14' and sys_platform != 'win32'",
     "python_full_version >= '3.11' and python_full_version < '3.14' and sys_platform == 'win32'",
-    "python_full_version < '3.11' and sys_platform == 'win32'",
     "python_full_version >= '3.11' and python_full_version < '3.14' and sys_platform != 'win32'",
+    "python_full_version < '3.11' and sys_platform == 'win32'",
     "python_full_version < '3.11' and sys_platform != 'win32'",
 ]
 
@@ -53,11 +53,11 @@ wheels = [
 
 [[package]]
 name = "certifi"
-version = "2026.6.17"
+version = "2026.10.23"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/c9/c7/424b75da314c1045981bd9777432fad05a9e0c69daa4ed7e308bbaffe405/certifi-2026.6.17.tar.gz", hash = "sha256:024c88eeec92ca068db80f02b8b07c9cef7b9fe261d1d535abfd5abd6f6af432", size = 134594, upload-time = "2026-06-17T10:31:07.894Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/fd/11/b524cbd9bbdaca58608e4cf4053fd463417549e1959fa8d3aa18319f9555/certifi-2026.10.23.tar.gz", hash = "sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd", size = 136225, upload-time = "2026-10-23T11:36:16.478Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ef/2f/c5464532e965badff2f4c4c1a3a83f5697f0d7c407ed0cda44aaa99bb451/certifi-2026.6.17-py3-none-any.whl", hash = "sha256:2227dcbaafe0d2f59279d1762ddddc37783ed4354594f194ffc31d20f41fc3db", size = 133289, upload-time = "2026-06-17T10:31:06.348Z" },
+    { url = "https://files.pythonhosted.org/packages/32/d1/a3652fe2c19134d0d15922177821d863cbd7e842d53a21bbe7e8e3a1b5ac/certifi-2026.10.23-py3-none-any.whl", hash = "sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1", size = 135082, upload-time = "2026-10-23T11:36:14.763Z" },
 ]
 
 [[package]]
@@ -356,7 +356,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -469,7 +469,7 @@ wheels = [
 
 [[package]]
 name = "mcp"
-version = "1.28.1"
+version = "1.30.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
@@ -487,9 +487,9 @@ dependencies = [
     { name = "typing-inspection" },
     { name = "uvicorn", marker = "sys_platform != 'emscripten'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/6e/77/9450b8f251a13affb6281997d0523c4615f8a8b35d0b21ff30db3a5aac9d/mcp-1.28.1.tar.gz", hash = "sha256:d51e36a5f5644faea4f85ea649bfffa6bc6c26770d42798ad6a3de3d2ba69683", size = 638501, upload-time = "2026-06-26T12:57:29.093Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ba/93/0142dc84a666daf8ad51a34268f34c12fd6fda4f3810c4be2504eecc8212/mcp-1.30.0.tar.gz", hash = "sha256:445414625fce5c295faa505bb11bacece661ab6f4028d57c935db57820b7a3e4", size = 680511, upload-time = "2026-09-07T14:34:15.845Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/e2/5e/d118fce19f87a2e7d8101c35c8ae0ec289098a4df0ff244cec23e415aca0/mcp-1.28.1-py3-none-any.whl", hash = "sha256:2726bca5e7193f61c5dde8b12500a6de2d9acf6d1a1c0be9e8c2e706437991df", size = 222620, upload-time = "2026-06-26T12:57:27.218Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/f4/e58bc33317c92a0203664daaf00bf6f41166cc0149e5d6870a03f7cd004a/mcp-1.30.0-py3-none-any.whl", hash = "sha256:666edb5009503e1047c9d60346a756f94b261f05cc2625f23d41c728ffc484d0", size = 234581, upload-time = "2026-09-07T14:34:14.266Z" },
 ]
 
 [package.optional-dependencies]
@@ -1293,9 +1293,10 @@ wheels = [
 
 [[package]]
 name = "vmware-debug"
-version = "2.3.0"
+version = "2.3.1"
 source = { editable = "." }
 dependencies = [
+    { name = "certifi" },
     { name = "mcp", extra = ["cli"] },
     { name = "pyyaml" },
     { name = "rich" },
@@ -1312,7 +1313,8 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "mcp", extras = ["cli"], specifier = ">=1.28,<2.0" },
+    { name = "certifi", specifier = ">=2026.10.19" },
+    { name = "mcp", extras = ["cli"], specifier = ">=1.30,<2.0" },
     { name = "pyyaml", specifier = ">=6.0,<7.0" },
     { name = "rich", specifier = ">=13.0,<15.0" },
     { name = "typer", specifier = ">=0.12,<1.0" },
@@ -1328,14 +1330,14 @@ dev = [
 
 [[package]]
 name = "vmware-policy"
-version = "1.24.0"
+version = "1.24.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pyyaml" },
     { name = "rich" },
     { name = "typer" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/4a/62/3a3cb83af77e3dd3c8fc92cb3b7968bfda04a2f71bf0d6f9b72ee3198441/vmware_policy-1.24.0.tar.gz", hash = "sha256:fba12732ccbd4371232c15d9fd014f9f5d697497210aedff2515d1d205ed3577", size = 361302, upload-time = "2026-10-16T07:18:28.317Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/15/8d/b9867ea1c0112caa481841c290c3fe718c0dbd738757db7877836f46267a/vmware_policy-1.24.2.tar.gz", hash = "sha256:6c816174fcd0b490bcd1f9ebaaa18b80fcb26b0eccb614e938938bb2e8452a40", size = 369315, upload-time = "2026-10-18T03:43:52.753Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/3d/f2/fe3d9d384712023916e2cacddc385f14b095509c5e00aea417d1a9550e98/vmware_policy-1.24.0-py3-none-any.whl", hash = "sha256:cf615d0256134f01fb84c39b083649281a66d2c064c2eaa28786a0fa95ec6e58", size = 131460, upload-time = "2026-10-16T07:18:26.907Z" },
+    { url = "https://files.pythonhosted.org/packages/20/01/bc5f984a420d22514d8c3a627f332891f2008213d455c2f682f311e355f1/vmware_policy-1.24.2-py3-none-any.whl", hash = "sha256:2734ab49a76474fd74beb221a2d6535caab1f91a477668484c145dc2802ae072", size = 134565, upload-time = "2026-10-18T03:43:50.856Z" },
 ]

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/vmware_debug/__init__.py

@@ -6,4 +6,4 @@ remediation to vmware-aiops / vmware-pilot. Never writes to any VMware system
 and never executes fixes; its only writes go to the local case ledger.
 """
 
-__version__ = "2.3.0"
+__version__ = "2.3.1"

{vmware_debug-2.3.0 → vmware_debug-2.3.1}/vmware_debug/cli.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 
 import json
 import sys
+from functools import wraps
 from pathlib import Path
 from typing import Optional
 
@@ -20,7 +21,7 @@ from rich.table import Table
 
 from vmware_debug import __version__
 from vmware_debug.mcp.tools import build_incident_timeline, list_symptom_categories
-from vmware_policy import audited, cli_local
+from vmware_policy import PolicyDenied, audited, cli_local, sanitize
 
 
 def _harden_console_encoding() -> None:
@@ -53,6 +54,19 @@ app = typer.Typer(
 console = Console()
 
 
+def handle_cli_errors(func):
+    """Render policy refusals after the audited wrapper has recorded the denial."""
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except PolicyDenied as exc:
+            rule = f" (rule: {sanitize(exc.result.rule, 100)})" if exc.result.rule else ""
+            typer.echo(f"Denied by policy: {sanitize(exc.result.reason, 500)}{rule}", err=True)
+            raise typer.Exit(1) from None
+    return wrapper
+
+
 @app.command()
 @cli_local("prints the installed version")
 def version() -> None:
@@ -61,6 +75,7 @@ def version() -> None:
 
 
 @app.command()
+@handle_cli_errors
 @audited(tool="list_symptom_categories")
 def categories() -> None:
     """List the symptom categories debug recognises and what to check for each."""
@@ -74,6 +89,7 @@ def categories() -> None:
 
 
 @app.command()
+@handle_cli_errors
 @audited(tool="build_incident_timeline")
 def triage(
     events_file: Optional[Path] = typer.Option(