@dx-do/cli 5.2.45 → 5.2.47

package/README.md

@@ -9,17 +9,30 @@
 :warning: Using npm install for this package is highly discouraged.
 
 
+# via npx
+
 ```
 npx @dx-do/cli@<version> <--config=<config-file>> command-group command <parameter>=<value>
 ```
+# via bunx
+
+```
+bunx @dx-do/cli@<version> <--config=<config-file>> command-group command <parameter>=<value>
+```
+
+# via binary
+
+```
+dx-do <--config=<config-file>> command-group command <parameter>=<value>
+```
 
 #### Output
 
 ```
-ℹ  info      dx-do v.dev-by-z@Zakis-Mac-Studio.local@2026-05-05T17:32-07:00 on node v22.17.0 on darwin-arm64 via node (ssl: 3.0.16)
+ℹ  info      dx-do v5.2.46 on node v22.21.0 on darwin-arm64 via node (ssl: 3.5.4)
 ⚠  warning   Not loading configuration
 ✖  error     Usage: dx-do --option[=value]... <command-group> <command> <command-param>=<value>...
-ℹ  info      Available command-groups: agent, vertex, auth, dashboard, jsextension, axa, config, channel, alert, nass, alarm, apm-universe, o2-universe, ui, help, trace, topographer, service, graph, metric, metrex, tas, experience, situation, sql, acc, o2-metricgrouping, o2-managementmodule, o2-alert, managementmodule, log, blob, perspective, metricgrouping, asm, inventory, event, attribute, audit, agentic
+ℹ  info      Available command-groups: acc, agent, agentic, alarm, alert, apm-universe, asm, attribute, audit, auth, axa, blob, channel, config, dashboard, diagnose, event, experience, graph, help, inventory, jsextension, log, managementmodule, metrex, metric, metricgrouping, nass, o2-alert, o2-managementmodule, o2-metricgrouping, o2-universe, perspective, service, situation, sql, tas, topographer, trace, ui, vertex
 ```
 
 
@@ -325,24 +338,34 @@ npx @dx-do/cli@<version> <--config=<config-file>> command-group command <paramet
 ⤜ alarm-data........................................: provides the situation alarm data
 ⤜ query.............................................: finds situations
 ```
-#### sql
-```sql
-⤜ examples..........................................: shows example queries
-⤜ query.............................................: executes an APM sql query
-⤜ date-to-timestamp.................................: converts dates to timestamps for use in queries
-```
 #### acc
 ```acc
+⤜ set-bundle-property...............................: sets a property override on a bundle within a package (single PATCH)
+⤜ package-required-bundles..........................: lists bundles required by a package (always-shipped framework set)
+⤜ package-property-overrides........................: lists property overrides applied on top of bundle defaults for a package
 ⤜ package-details...................................: gets package details
+⤜ package-compatible-bundles........................: lists bundles compatible with a package (candidate add-bundle set)
 ⤜ package-bundles...................................: gets package bundles
+⤜ package-bundle-profile............................: fetches a single bundle's profile (property catalog + overrides) within a package
+⤜ package-builder-options...........................: lists valid environment combinations for create-package (UI 'new package' wizard data)
 ⤜ list-packages.....................................: lists acc packages
 ⤜ list-bundles......................................: lists acc bundles
 ⤜ initialize-bundle-directory.......................: initialize a prepared bundle directory
 ⤜ import-packages...................................: import packages from an export file
 ⤜ import-bundle.....................................: import bundle from a bundle tar.gz file
 ⤜ export-packages...................................: exports packages to a file
+⤜ download-package..................................: downloads a server-assembled tenant-stamped agent package tarball
 ⤜ download-bundle...................................: downloads bundle
+⤜ delete-package....................................: deletes a package
+⤜ create-package....................................: creates a new ACC package from typed args (UI new-package wizard equivalent)
 ⤜ bundle-details....................................: gets bundle details
+⤜ add-package-bundles...............................: attaches bundles to a package (single PATCH, no draft/publish dance)
+```
+#### sql
+```sql
+⤜ examples..........................................: shows example queries
+⤜ query.............................................: executes an APM sql query
+⤜ date-to-timestamp.................................: converts dates to timestamps for use in queries
 ```
 #### o2-metricgrouping
 ```o2-metricgrouping
@@ -427,13 +450,20 @@ npx @dx-do/cli@<version> <--config=<config-file>> command-group command <paramet
 ```attribute
 ⤜ dump..............................................: dumps all attributes by layer
 ```
+#### diagnose
+```diagnose
+⤜ services..........................................: Audit the bound tenant's DXO2 service organization. Returns severity-tagged findings (errors / warnings / recommendations) per service. Optionally scope by serviceName (with or without descendants). [experimental]
+⤜ explain...........................................: Explain every diagnostic rule (or filter to one scope). Pure metadata — no tenant binding required. [experimental]
+```
 #### audit
 ```audit
 ⤜ query.............................................: query data-store audit events
 ```
 #### agentic
 ```agentic
+⤜ schema............................................: Emit the canonical JSON Schema for a DataStore query payload (TAS / NASSQL / Metrics-Metadata), optionally narrowed to one op. [experimental]
 ⤜ mcp...............................................: Run a stdio MCP server for the bound tenant. Wire into Claude Code / Cursor with `claude mcp add` (or equivalent). [experimental]
+⤜ learn-tenant......................................: Reserve the per-tenant corpus storage at ~/.dxdo/<alias>/corpus/ (no-op stub; full learning logic is forthcoming). [experimental]
 ⤜ extract-claude-marketplace........................: Extract the embedded Claude Code marketplace + plugins to disk. Writes `<base-directory>/dx-do-claude-marketplace/` containing the marketplace.json and one subdir per plugin. Prints the `/plugin` slash-command sequence to install them. [experimental]
 ⤜ corpus-sections...................................: List the sections of the dx-do catalog (queries, cookbooks, entities, …). [experimental]
 ⤜ corpus-section-index..............................: List entries in a catalog section. Each row is labelled `<section>/<id>` for copy-paste into `agentic corpus-entry`. [experimental]
@@ -473,7 +503,7 @@ npx @dx-do/cli alert list
 
 ***
 
-#### proxyConfig
+## proxyConfig
 
 ```
 --proxyConfig=<proxyConfigFilename>
@@ -495,12 +525,29 @@ npx @dx-do/cli alert list
 
 ***
 
-#### non interactive mode (suitable for running from a script)
+### non interactive mode (suitable for running from a script)
 
 ```
 --noninteractive
 ```
 
+### Experimental commands
+
+Some `dx-do` commands are marked **experimental** — they're being designed, may change shape between releases, or are only safe to run on test tenants. They're hidden from `dx-do help commands` and refused at runtime by default. Open the gate either way:
+
+* **Per-invocation flag**: `dx-do --enable-experimental-commands <group> <command> ...`
+* **Env var**: `export DXDO_ENABLE_EXPERIMENTAL_COMMANDS=true`
+
+Both forms behave identically; pick whichever fits your workflow. The env var is the better choice when you need experimental commands repeatedly (CI, scripts, an MCP-server-spawn config in Claude Code / Cursor).
+
+To see which commands are experimental, run any of:
+
+* `DXDO_ENABLE_EXPERIMENTAL_COMMANDS=true dx-do help commands` — list with `[experimental]` tag.
+* The `README.md` shipped with the binary — generated with experimental commands always included; each is suffixed with `[experimental]`.
+
+When an MCP client (Claude Code, Cursor, mcp-inspector) spawns `dx-do` as a subprocess for a currently-experimental command (e.g. `agentic mcp`), set the env var in the spawn config so the gate is open for the child process. The bundled `investigate@dx-do` Claude Code plugin already does this in its `plugin.json`.
+
+
 #### version 3 configuration
 
 Please upgrade version 3 configurations using "config upgrade"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dx-do/cli",
-  "version": "5.2.45",
+  "version": "5.2.47",
   "description": "CLI execution of DX Operational Observability operations and triage",
   "author": "Ki Alam",
   "logo": {