wxcli 1.2.0__tar.gz → 1.3.1__tar.gz

wxcli-1.3.1/.claude/settings.json

@@ -0,0 +1,16 @@
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  },
+  "permissions": {
+    "allow": [
+      "Bash(wxcli:*)",
+      "Bash(which:*)",
+      "Bash(pip install -e:*)",
+      "Bash(pip3 install -e:*)",
+      "Bash(pip3.11:*)",
+      "Bash(python3.11:*)",
+      "Bash(PYTHONPATH=.:*)"
+    ]
+  }
+}

{wxcli-1.2.0 → wxcli-1.3.1}/.github/workflows/release.yml

@@ -24,7 +24,7 @@ jobs:
           python wxcli-dist/assemble.py
           if [ -n "$(git status --porcelain -- src/wxcli/_playbook)" ]; then
             git status --porcelain -- src/wxcli/_playbook
-            echo "::error::src/wxcli/_playbook is stale — run 'python wxcli-dist/assemble.py', review the diff, commit, re-tag."
+            echo "::error::src/wxcli/_playbook (Claude + Codex playbook) is stale — run 'python wxcli-dist/assemble.py', review the diff, commit, re-tag."
             exit 1
           fi
 
@@ -33,6 +33,9 @@ jobs:
           python -m pip install --upgrade pip build
           python -m build
 
+      - name: Verify the installed wheel playbook
+        run: python tools/wheel_playbook_smoke.py dist/wxcli-*.whl
+
       - name: Version guard (never publish a dirty version)
         run: |
           TAG="${{ github.event.release.tag_name }}"

{wxcli-1.2.0 → wxcli-1.3.1}/.gitignore

@@ -52,6 +52,7 @@ tests/*
 !tests/migration/**
 !tests/org_health/
 !tests/org_health/**
+!tests/test_release_integrity.py
 tests/migration/**/__pycache__/
 tests/org_health/**/__pycache__/
 
@@ -69,6 +70,7 @@ tests/migration/cucm/validate_live_cucm.py
 !.github/workflows/
 .github/workflows/*
 !.github/workflows/release.yml
+!.github/workflows/ci.yml
 
 # Coverage
 .coverage

{wxcli-1.2.0 → wxcli-1.3.1}/CLAUDE.md

@@ -15,6 +15,17 @@ For every question — capability, configuration, behavior, limits, or anything
 
 The reference docs and skills are the authoritative source for this project. Training data about Cisco/Webex products is unreliable — product tiers get conflated, feature names change, and capabilities vary by license. If the answer isn't in the docs or skills, say so explicitly rather than filling the gap from training data.
 
+## Plain-English Communication Rule
+
+The target user has ZERO platform experience. When explaining findings, trade-offs, or decisions — or asking the user to choose between options — do NOT lead with jargon, acronyms, or internal feature-names. Instead:
+- Lead with **"what we're actually deciding"** in one plain sentence.
+- Replace every technical term with a **concrete before/after of what the user would type or see** (e.g. "Today you type X and see Y; the other way you'd type/see Z").
+- Answer their real questions directly: **what should we do, why, is it easy to maintain, what risks breaking.**
+- **End with a clear recommendation**, not a neutral menu of options.
+- If a technical term must appear, define it inline the first time.
+
+This applies to chat answers AND the option text in any question you ask the user.
+
 ## Execution Discipline
 
 - **Verify before claiming done.** Run the command, check the output, confirm the state. Never report success from inference alone. Ask yourself: "Would a staff engineer approve this?"
@@ -101,11 +112,11 @@ wxcli dect-devices show "Y2lz..."
 
 ### Agent Orchestration — Long-Running Work & Silence Detection
 
-Added 2026-04-15 after an org-cleanup subagent died mid-Phase-2 when its Python polling loop exceeded Bash's 10-min timeout. Parent sent two `SendMessage` pings that received no response because the subagent's tool call was still in flight and then terminated; the agent loop never got a chance to resume and handle the messages. Root cause recovery required spawning a fresh agent to verify org state and finish the job. This protocol **complements** — does not replace — the phase-per-invocation rule above.
+A subagent can die mid-work when a long-running tool call (e.g. a Python polling loop) outlives Bash's ~10-min timeout: the call is killed, the agent loop never resumes to emit a final message, and `SendMessage` pings queue to a dead mailbox. This protocol prevents and recovers from that; it **complements** — does not replace — the phase-per-invocation rule above.
 
 #### For subagents running long-running work (>2 min expected)
 
-1. **Never wrap long-running polling in a single Bash call.** The Bash tool has a ~10-min hard timeout; if the tool call runs longer, stdout buffering hides progress and the subagent dies silently when the kernel kills the process. The agent loop never resumes to produce a final message, so the parent sees silence.
+1. **Never wrap long-running polling in a single Bash call.** A call that outlives the ~10-min hard timeout is killed mid-run; stdout buffering hides progress and the parent sees silence (see the failure mode above).
 2. **Split into discrete tool calls.** One Bash call per polling round (not 20 rounds in one call). Between rounds, the agent loop can emit progress messages.
 3. **Use `run_in_background: true` on Bash** for genuinely long-running commands (e.g., `wxcli cucm execute` that runs >5 min); monitor the task output file (but do not `tail`/Read large JSONL transcripts — use targeted line ranges only).
 4. **Emit progress explicitly.** At minimum every 60s, the subagent should produce a visible message (text output, not a tool call) so observers see aliveness.
@@ -155,25 +166,13 @@ Added 2026-04-15 after an org-cleanup subagent died mid-Phase-2 when its Python
 
 ### Skill Disambiguation
 
-When multiple skills could match, use this lookup:
+When multiple skills could match, use this lookup. (Basic skill-vs-skill routing already lives in each skill's `NOT for:` description, which the session always sees — the rows below cover only what those don't resolve: subtle overlaps, Calling-vs-CC terminology collisions, and undocumented capabilities.)
 
 | If the user wants to... | Use this skill | NOT this one |
 |--------------------------|---------------|-------------|
-| Configure Customer Assist (screen pop, wrap-up, supervisors) | `customer-assist` | `configure-features` (CX queues are a separate skill) |
-| Create a call queue, hunt group, or auto attendant | `configure-features` | `customer-assist` (only for CX Essentials features) |
-| Set person call forwarding, DND, voicemail, caller ID | `manage-call-settings` | `configure-features` (person settings ≠ call features) |
-| Add/remove phone numbers on a user, number reassignment | `manage-call-settings` | `provision-calling` (that's for initial user/license creation) |
+| Add/remove phone numbers on a user, number reassignment | `manage-call-settings` | `provision-calling` (that's for initial user/license creation; provision-calling owns number *inventory*, not per-user assignment) |
 | Update user profile fields (alternate numbers, display name) | `provision-calling` | `manage-call-settings` (profile fields are People API, not telephony config) |
-| Configure voicemail groups (shared location mailbox) | `configure-features` | `manage-call-settings` (voicemail groups are a location feature) |
-| Provision MPP phones, DECT, activation codes | `manage-devices` | `device-platform` (that's for config keys, not provisioning) |
-| Set 9800-series PhoneOS config keys, xAPI commands | `device-platform` | `manage-devices` (that's for provisioning, not config) |
-| Query Webex Calling CDR, call quality, queue stats | `reporting` | `reporting-cc` (that's Contact Center only) |
-| Query Contact Center agent/queue analytics | `reporting-cc` | `reporting` (that's Calling only) |
-| Query meeting quality, workspace utilization | `reporting-meetings` | `reporting` (different API domain) |
-| Delete/clean up resources | `teardown` | `provision-calling` (that's for creation) |
-| Provision users, locations, licenses | `provision-calling` | `teardown` (that's for deletion) |
-| Map numbers to CC entry points, CC dial numbers | `contact-center` | `configure-routing` (that's Calling routing, not CC routing) |
-| CC entry points, teams, skills, agents, queues, flows | `contact-center` | `configure-features` (that's Calling features, not CC) |
+| Configure voicemail groups (shared location mailbox) | `configure-features` | `manage-call-settings` ("voicemail" collides: groups are a location feature, not person voicemail) |
 | **Calling vs CC terminology — when the same word means different things:** | | |
 | "Create a queue" (Calling call queue) | `configure-features` | `contact-center` (that's CC queues — different API, different entity) |
 | "Create a queue" (Contact Center queue) | `contact-center` | `configure-features` (that's Calling queues — no skill-based routing) |

{wxcli-1.2.0 → wxcli-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wxcli
-Version: 1.2.0
+Version: 1.3.1
 Summary: Webex Calling CLI — terminal-based provisioning for Webex APIs
 Author: Adam Hobgood
 License: Apache-2.0
@@ -94,17 +94,17 @@ pip install wxcli
 
 Works on macOS, Linux, and Windows. On Windows, first install [Python 3.11+](https://www.python.org/downloads/) (tick **"Add python.exe to PATH"** during setup); then `python -m pip install --user pipx && python -m pipx ensurepath` gives you `pipx`. `pipx`/`pip` pull every dependency automatically.
 
-### From source (for development or the Claude Code playbook)
+### Get the playbook (Claude Code or Codex)
 
-The Claude Code playbook (agents, skills, reference docs) lives in the repo, not the wheel. Clone if you want the playbook or plan to develop wxcli:
+The playbook (agents, skills, reference docs) ships **inside the wheel** in both Claude Code and Codex shapes. After installing, materialize it into a folder with `wxcli init` — which writes **both** by default, so the same folder works in either tool:
 
 ```bash
-git clone https://github.com/achobgood/wxops.git
-cd wxops
-pip install -e .
+wxcli init                   # writes the Claude Code + Codex playbook into ./wxcli-playbook
+cd wxcli-playbook && claude  # start Claude Code…
+cd wxcli-playbook && codex   # …or start Codex — reads AGENTS.md + .codex/
 ```
 
-On Windows this also needs [Git](https://git-scm.com/download/win). The version is derived from git tags at install time, so a full clone (not a shallow/zip download) is required.
+Narrow with `wxcli init --claude-only` or `wxcli init --codex-only`. `wxcli init --uninstall` removes the materialized files again. No clone required.
 
 ## Authenticate
 
@@ -147,15 +147,9 @@ wxcli update           # check PyPI and upgrade in place
 wxcli update --check   # report the latest version without upgrading
 ```
 
-`wxcli update` detects how it was installed and upgrades accordingly — `pipx upgrade wxcli` for pipx installs, `pip install --upgrade wxcli` for pip installs — then deep-links the release notes for the new version. No git required.
+`wxcli update` detects how it was installed and upgrades accordingly — `pipx upgrade wxcli` for pipx installs, `pip install --upgrade wxcli` for pip installs — then deep-links the release notes for the new version.
 
-**If you originally cloned the repo** (a source/dev install), `wxcli update` prints guidance instead of upgrading. To move to a managed install, run:
-
-```bash
-wxcli update --migrate   # installs via pipx, removes the old editable install
-```
-
-Developers who want to keep hacking on the source stay on `git pull`. Behind a firewall that blocks PyPI? Point `WXCLI_UPDATE_INDEX_URL` at an internal mirror, or install fresh with `pipx install wxcli` and abandon the clone.
+Behind a firewall that blocks PyPI? Point `WXCLI_UPDATE_INDEX_URL` at an internal mirror, or install fresh with `pipx install wxcli`.
 
 ## Claude Code Playbook
 
@@ -175,8 +169,8 @@ A guided AI assistant that walks you through Webex Calling configuration end-to-
 ### How to Use It
 
 1. Install [Claude Code](https://claude.com/claude-code)
-2. Clone this repo and `cd` into it — the clone delivers the **playbook** (agents/skills/docs)
-3. Install the CLI: `pip install -e .` (or use a PyPI-installed `wxcli` — the playbook drives whichever `wxcli` is on your PATH)
+2. Install the CLI: `pipx install wxcli`
+3. Run `wxcli init` and `cd wxcli-playbook` — this delivers the **playbook** (agents/skills/docs) from the wheel
 4. Run `claude` to start Claude Code
 5. Use `/agents` and select **wxc-calling-builder** to begin
 6. Or use `/wxc-calling-debug` to troubleshoot a specific issue
@@ -442,7 +436,6 @@ wxops/
 ## Requirements
 
 - Python 3.11+ (includes `pip`)
-- Git — required to clone the repo *and* to build it (the version is derived from git tags at install time)
 - A Webex admin account with access tokens
 
 ### OAuth Scopes

{wxcli-1.2.0 → wxcli-1.3.1}/README.md

@@ -57,17 +57,17 @@ pip install wxcli
 
 Works on macOS, Linux, and Windows. On Windows, first install [Python 3.11+](https://www.python.org/downloads/) (tick **"Add python.exe to PATH"** during setup); then `python -m pip install --user pipx && python -m pipx ensurepath` gives you `pipx`. `pipx`/`pip` pull every dependency automatically.
 
-### From source (for development or the Claude Code playbook)
+### Get the playbook (Claude Code or Codex)
 
-The Claude Code playbook (agents, skills, reference docs) lives in the repo, not the wheel. Clone if you want the playbook or plan to develop wxcli:
+The playbook (agents, skills, reference docs) ships **inside the wheel** in both Claude Code and Codex shapes. After installing, materialize it into a folder with `wxcli init` — which writes **both** by default, so the same folder works in either tool:
 
 ```bash
-git clone https://github.com/achobgood/wxops.git
-cd wxops
-pip install -e .
+wxcli init                   # writes the Claude Code + Codex playbook into ./wxcli-playbook
+cd wxcli-playbook && claude  # start Claude Code…
+cd wxcli-playbook && codex   # …or start Codex — reads AGENTS.md + .codex/
 ```
 
-On Windows this also needs [Git](https://git-scm.com/download/win). The version is derived from git tags at install time, so a full clone (not a shallow/zip download) is required.
+Narrow with `wxcli init --claude-only` or `wxcli init --codex-only`. `wxcli init --uninstall` removes the materialized files again. No clone required.
 
 ## Authenticate
 
@@ -110,15 +110,9 @@ wxcli update           # check PyPI and upgrade in place
 wxcli update --check   # report the latest version without upgrading
 ```
 
-`wxcli update` detects how it was installed and upgrades accordingly — `pipx upgrade wxcli` for pipx installs, `pip install --upgrade wxcli` for pip installs — then deep-links the release notes for the new version. No git required.
+`wxcli update` detects how it was installed and upgrades accordingly — `pipx upgrade wxcli` for pipx installs, `pip install --upgrade wxcli` for pip installs — then deep-links the release notes for the new version.
 
-**If you originally cloned the repo** (a source/dev install), `wxcli update` prints guidance instead of upgrading. To move to a managed install, run:
-
-```bash
-wxcli update --migrate   # installs via pipx, removes the old editable install
-```
-
-Developers who want to keep hacking on the source stay on `git pull`. Behind a firewall that blocks PyPI? Point `WXCLI_UPDATE_INDEX_URL` at an internal mirror, or install fresh with `pipx install wxcli` and abandon the clone.
+Behind a firewall that blocks PyPI? Point `WXCLI_UPDATE_INDEX_URL` at an internal mirror, or install fresh with `pipx install wxcli`.
 
 ## Claude Code Playbook
 
@@ -138,8 +132,8 @@ A guided AI assistant that walks you through Webex Calling configuration end-to-
 ### How to Use It
 
 1. Install [Claude Code](https://claude.com/claude-code)
-2. Clone this repo and `cd` into it — the clone delivers the **playbook** (agents/skills/docs)
-3. Install the CLI: `pip install -e .` (or use a PyPI-installed `wxcli` — the playbook drives whichever `wxcli` is on your PATH)
+2. Install the CLI: `pipx install wxcli`
+3. Run `wxcli init` and `cd wxcli-playbook` — this delivers the **playbook** (agents/skills/docs) from the wheel
 4. Run `claude` to start Claude Code
 5. Use `/agents` and select **wxc-calling-builder** to begin
 6. Or use `/wxc-calling-debug` to troubleshoot a specific issue
@@ -405,7 +399,6 @@ wxops/
 ## Requirements
 
 - Python 3.11+ (includes `pip`)
-- Git — required to clone the repo *and* to build it (the version is derived from git tags at install time)
 - A Webex admin account with access tokens
 
 ### OAuth Scopes

{wxcli-1.2.0 → wxcli-1.3.1}/pyproject.toml

@@ -50,9 +50,9 @@ wxcli = "wxcli.main:app"
 where = ["src"]
 
 [tool.setuptools.package-data]
-# Both patterns are required: setuptools' recursive glob does not descend
-# into dot-directories, so "_playbook/**" alone would drop .claude/ from the wheel.
-wxcli = ["_playbook/**", "_playbook/.claude/**"]
+# Explicit dot-directory patterns are required: setuptools' recursive glob does
+# not descend into them, so "_playbook/**" alone would drop Claude/Codex files.
+wxcli = ["_playbook/**", "_playbook/.claude/**", "_playbook/.codex/**"]
 
 [tool.setuptools_scm]
 write_to = "src/wxcli/_version.py"

{wxcli-1.2.0 → wxcli-1.3.1}/specs/webex-admin.json

@@ -28478,7 +28478,7 @@
           },
           "roles": {
             "type": "array",
-            "description": "The roles assigned to the admin for managing the customer group.",
+            "description": "The roles assigned to the admin for managing the customer group. For initial release both External Admin and Partner Admin will only support one set of roles: `id_full_admin + atlas-portal.partner.provision_admin`.",
             "items": {
               "type": "string"
             }
@@ -32968,7 +32968,11 @@
             "description": "The roles assigned to the admin for managing the customer group.",
             "items": {
               "type": "string"
-            }
+            },
+            "example": [
+              "atlas-portal.partner.provision_admin",
+              "id_full_admin"
+            ]
           }
         }
       },
@@ -33229,7 +33233,7 @@
           },
           "roles": {
             "type": "array",
-            "description": "The roles assigned to the admin.",
+            "description": "The roles assigned to the admin. For initial release both External Admin and Partner Admin will only support one set of roles: `id_full_admin + atlas-portal.partner.provision_admin`.",
             "items": {
               "type": "string"
             },
@@ -33269,7 +33273,7 @@
           },
           "roles": {
             "type": "array",
-            "description": "The roles assigned to the admin.",
+            "description": "The roles assigned to the admin. For initial release both External Admin and Partner Admin will only support one set of roles: `id_full_admin + atlas-portal.partner.provision_admin`.",
             "items": {
               "type": "string"
             },