@carllee1983/dbcli 1.20.2 → 1.23.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,35 @@
1
+ ---
2
+ name: analyze-table-perf
3
+ description: Inspect a single table's structure, indexes and read-only performance signals.
4
+ tags: [diagnostics, performance, readonly]
5
+ engines: [postgres, mysql]
6
+ params:
7
+ table:
8
+ type: string
9
+ required: true
10
+ description: The table to analyze (exact name; confirm via `dbcli list`).
11
+ safety:
12
+ mode: plan-only
13
+ requires:
14
+ - blacklist-list
15
+ - schema-check
16
+ steps:
17
+ - type: command
18
+ command: blacklist list
19
+ reason: Confirm sensitive tables and columns are protected before inspection.
20
+ risk: readonly
21
+ - type: command
22
+ command: schema {{table}} --format json
23
+ reason: Inspect the table's columns and existing indexes.
24
+ risk: readonly
25
+ - type: command
26
+ command: guide index-usage --format json
27
+ reason: Review index-usage guidance to spot missing or unused indexes.
28
+ risk: readonly
29
+ ---
30
+ # Agent Notes
31
+
32
+ Use this task when a table shows up as the hottest target in recent activity and
33
+ you want safe, read-only next steps to assess its performance characteristics.
34
+ Do not run write operations. For a single heavy query, prefer
35
+ `dbcli guide missing-index-for "<sql>"` instead.