queue-aiops 0.8.0__tar.gz → 0.9.1__tar.gz

queue_aiops-0.9.1/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
+  "name": "queue-aiops",
+  "displayName": "Queue AIops",
+  "version": "0.9.1",
+  "description": "Governed redis + rabbitmq ops: memory/latency/backlog/churn RCA, policies. 28 tools.",
+  "author": {
+    "name": "Wei Zhou",
+    "email": "zhouwei008@gmail.com",
+    "url": "https://github.com/AIops-tools"
+  },
+  "homepage": "https://github.com/AIops-tools/Queue-AIops",
+  "repository": "https://github.com/AIops-tools/Queue-AIops",
+  "license": "MIT",
+  "keywords": [
+    "aiops",
+    "mcp",
+    "governance",
+    "queue"
+  ]
+}

queue_aiops-0.9.1/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "queue-aiops": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "queue-aiops==0.9.1",
+        "queue-aiops-mcp"
+      ]
+    }
+  }
+}

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## v0.9.1 — 2026-09-12
+
+### Added
+- **The OpenClaw install path is documented.** The ClawHub bundle channel went
+  live but neither the README nor this skill said how to install from it:
+  `openclaw plugins install clawhub:@aiops-tools/queue-aiops`. States the `uvx`
+  prerequisite (without it the skill installs but reports `Visible to model:
+  no`) and that the MCP server is pinned to this exact release.
+- **Where an exported master password lives** is now stated next to the
+  instruction to export it: readable by every process the shell starts, and
+  kept in shell history.
+
+## v0.9.0 — 2026-09-12
+
+### Added
+- **Installable as a Claude Code plugin.** `.claude-plugin/plugin.json` plus a
+  root `.mcp.json` make this repo a plugin, so `/plugin install queue-aiops@aiops-tools`
+  delivers the skill and registers the MCP server in one step. The server is
+  pinned to the exact package version the manifest declares, so an audit row
+  stays traceable to the code that produced it. Nothing about the tool itself
+  changed — the CLI and the standalone MCP server work exactly as before.
+- **Installable from ClawHub as an OpenClaw bundle plugin** (`@aiops-tools/queue-aiops`): one install delivers the skill *and* its MCP
+  server, pinned to this exact release. `clawhub.ai/plugins`.
+
+### Fixed
+- **The skill was invisible to the model in OpenClaw.** Its metadata
+  declared `requires.config` (OpenClaw reads that as config *keys*, not file
+  paths, so it can never be satisfied), `requires.env` and `requires.bins`
+  naming our own CLI — which a plugin user never has on PATH — plus a
+  `primaryEnv` that turned a config path into an API-key prompt. Measured on
+  OpenClaw 2026.6.35: `Visible to model: no`. It now requires
+  `anyBins: [queue-aiops, uvx]` — either one suffices — with every variable kept
+  in `optional.env` (still declared, no longer a load gate), which the same
+  command reports as `Visible to model: yes`.
 ## v0.8.0 — 2026-08-10
 
 ### Fixed

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: queue-aiops
-Version: 0.8.0
+Version: 0.9.1
 Summary: Governed AI-ops for redis + rabbitmq: memory-pressure/latency/queue-backlog/connection-churn RCAs, slowlog and SCAN-budgeted big-key sampling, queues/policies/nodes, and governed writes (config set, client kill, purge/delete queue, policies) with a built-in governance harness (audit, budget, undo, risk tiers)
 Author-email: Wei Zhou <zhouwei008@gmail.com>
 License-Expression: MIT
@@ -40,6 +40,36 @@ by the built-in governance harness.
 
 ## Quick start
 
+### As a Claude Code plugin
+
+One install gives an agent both the skill and the MCP server:
+
+```
+/plugin marketplace add AIops-tools/marketplace
+/plugin install queue-aiops@aiops-tools
+```
+
+The MCP server is fetched with [uv](https://docs.astral.sh/uv/) and pinned to the
+package version this plugin declares, so an audit row can be traced back to the
+code that wrote it. Credentials are still configured with `queue-aiops init` — see below.
+
+### As an OpenClaw plugin
+
+The same bundle is published on [ClawHub](https://clawhub.ai/plugins), where one
+install delivers the skill and its MCP server together:
+
+```bash
+openclaw plugins install clawhub:@aiops-tools/queue-aiops
+openclaw skills info queue-aiops          # expect: Visible to model: yes
+```
+
+Restart the OpenClaw gateway afterwards so it loads the plugin. The MCP server is
+fetched with [uv](https://docs.astral.sh/uv/), pinned to this exact release, so
+`uvx` has to be on `PATH` — without it the skill still installs but reports
+`Visible to model: no`. Credentials are configured exactly as below.
+
+### As a CLI or standalone MCP server
+
 ```bash
 uv tool install queue-aiops
 

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/README.md

@@ -23,6 +23,36 @@ by the built-in governance harness.
 
 ## Quick start
 
+### As a Claude Code plugin
+
+One install gives an agent both the skill and the MCP server:
+
+```
+/plugin marketplace add AIops-tools/marketplace
+/plugin install queue-aiops@aiops-tools
+```
+
+The MCP server is fetched with [uv](https://docs.astral.sh/uv/) and pinned to the
+package version this plugin declares, so an audit row can be traced back to the
+code that wrote it. Credentials are still configured with `queue-aiops init` — see below.
+
+### As an OpenClaw plugin
+
+The same bundle is published on [ClawHub](https://clawhub.ai/plugins), where one
+install delivers the skill and its MCP server together:
+
+```bash
+openclaw plugins install clawhub:@aiops-tools/queue-aiops
+openclaw skills info queue-aiops          # expect: Visible to model: yes
+```
+
+Restart the OpenClaw gateway afterwards so it loads the plugin. The MCP server is
+fetched with [uv](https://docs.astral.sh/uv/), pinned to this exact release, so
+`uvx` has to be on `PATH` — without it the skill still installs but reports
+`Visible to model: no`. Credentials are configured exactly as below.
+
+### As a CLI or standalone MCP server
+
 ```bash
 uv tool install queue-aiops
 

queue_aiops-0.9.1/openclaw.plugin.json

@@ -0,0 +1,24 @@
+{
+  "id": "queue-aiops",
+  "name": "Queue AIops",
+  "description": "Governed redis + rabbitmq ops: memory/latency/backlog/churn RCA, policies. 28 tools.",
+  "skills": [
+    "./skills"
+  ],
+  "mcpServers": {
+    "queue-aiops": {
+      "transport": "stdio",
+      "command": "uvx",
+      "args": [
+        "--from",
+        "queue-aiops==0.9.1",
+        "queue-aiops-mcp"
+      ]
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

queue_aiops-0.9.1/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@aiops-tools/queue-aiops",
+  "version": "0.9.4",
+  "description": "Governed redis + rabbitmq ops: memory/latency/backlog/churn RCA, policies. 28 tools.",
+  "private": true,
+  "license": "MIT",
+  "homepage": "https://github.com/AIops-tools/Queue-AIops",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AIops-tools/Queue-AIops.git"
+  },
+  "openclaw": {
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2"
+    },
+    "build": {
+      "openclawVersion": "2026.3.24-beta.2"
+    }
+  }
+}

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "queue-aiops"
-version = "0.8.0"
+version = "0.9.1"
 description = "Governed AI-ops for redis + rabbitmq: memory-pressure/latency/queue-backlog/connection-churn RCAs, slowlog and SCAN-budgeted big-key sampling, queues/policies/nodes, and governed writes (config set, client kill, purge/delete queue, policies) with a built-in governance harness (audit, budget, undo, risk tiers)"
 readme = "README.md"
 license = "MIT"

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/queue_aiops/governance/decorators.py

@@ -384,10 +384,10 @@ def _finalize(state: _CallState) -> None:
     # so the row must not assert a failure the tool cannot actually vouch for.
     if state.status == "ok" and isinstance(state.result, dict):
         # is_unknown is checked FIRST and independently of ``error``. A write
-        # can be undetermined while looking perfectly successful — a Proxmox
-        # task that has not finished yet returns a normal payload — and gating
-        # this on ``error`` audited those as 'ok', re-creating the very lie the
-        # unknown verdict exists to prevent.
+        # can be undetermined while looking perfectly successful — an upstream
+        # async task that has not finished yet returns a normal payload — and
+        # gating this on ``error`` audited those as 'ok', re-creating the very
+        # lie the unknown verdict exists to prevent.
         if is_unknown(state.result):
             state.status = "unknown"
         elif state.result.get("error"):

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/AIops-tools/Queue-AIops",
     "source": "github"
   },
-  "version": "0.8.0",
+  "version": "0.9.1",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "queue-aiops",
-      "version": "0.8.0",
+      "version": "0.9.1",
       "transport": {
         "type": "stdio"
       }

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/skills/queue-aiops/SKILL.md

@@ -17,7 +17,7 @@ installer:
 argument-hint: "[a queue/key/client id, or describe your cache/broker task]"
 allowed-tools:
   - Bash
-metadata: {"openclaw":{"requires":{"env":["QUEUE_AIOPS_CONFIG"],"bins":["queue-aiops"],"config":["~/.queue-aiops/config.yaml","~/.queue-aiops/secrets.enc"]},"optional":{"env":["QUEUE_AIOPS_MASTER_PASSWORD"]},"primaryEnv":"QUEUE_AIOPS_CONFIG","homepage":"https://github.com/AIops-tools/Queue-AIops","emoji":"📬","os":["macos","linux"]}}
+metadata: {"openclaw":{"requires":{"anyBins":["queue-aiops","uvx"]},"optional":{"env":["QUEUE_AIOPS_CONFIG","QUEUE_AIOPS_MASTER_PASSWORD"]},"homepage":"https://github.com/AIops-tools/Queue-AIops","emoji":"📬","os":["macos","linux"]}}
 compatibility: >
   Standalone, self-governed broker operations across redis (RESP wire protocol via the redis Python client; password optional — auth-less lab instances are supported — TLS optional) and rabbitmq (management HTTP API /api/..., HTTP Basic auth with a monitoring/management-tagged user). Each target in the config names its own platform, and a name-keyed platform registry selects the protocol shape, so one config can span a mixed estate. The governance harness (audit, policy, token/runaway budget, undo, risk-tiers) is bundled in the package — no external skill-family dependency.
   All write operations are audited to a local SQLite DB under ~/.queue-aiops/ (relocatable via QUEUE_AIOPS_HOME).
@@ -75,6 +75,15 @@ queue-aiops init       # wizard: pick platform (redis/rabbitmq) + encrypted secr
 queue-aiops doctor
 ```
 
+Or as an OpenClaw plugin, which installs this skill and its MCP server together:
+
+```bash
+openclaw plugins install clawhub:@aiops-tools/queue-aiops
+openclaw skills info queue-aiops          # expect: Visible to model: yes
+```
+
+Needs `uvx` on `PATH`: the MCP server is fetched with uv, pinned to this release.
+
 ## When to Use This Skill
 
 - Get a one-shot snapshot (`overview` / `redis_server_info` / `rabbitmq_overview`)

{queue_aiops-0.8.0 → queue_aiops-0.9.1}/uv.lock

@@ -812,7 +812,7 @@ wheels = [
 
 [[package]]
 name = "queue-aiops"
-version = "0.8.0"
+version = "0.9.1"
 source = { editable = "." }
 dependencies = [
     { name = "cryptography" },