@carllee1983/dbcli 1.51.1 → 1.51.2

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dbcli-agent",
3
- "version": "1.51.1",
3
+ "version": "1.51.2",
4
4
  "description": "Database CLI skill and command reference for AI agents.",
5
5
  "contextFileName": "AGENTS.md"
6
6
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@carllee1983/dbcli",
3
- "version": "1.51.1",
3
+ "version": "1.51.2",
4
4
  "description": "Database CLI for AI agents",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dbcli-agent",
3
- "version": "1.51.1",
3
+ "version": "1.51.2",
4
4
  "description": "Database CLI skill and command reference for AI agents",
5
5
  "author": {
6
6
  "name": "Carl Lee",
@@ -82,6 +82,30 @@ warnings) go to stderr so stdout stays parseable — when piping JSON into a par
82
82
  use `2>/dev/null` or leave stderr alone. **Never `2>&1`**: it merges those lines back
83
83
  into stdout and the parse fails.
84
84
 
85
+ **Intent confirmation:** Treat `auto`, `confirm`, and `guided` as conversational
86
+ preferences for the current request, not as dbcli flags or persistent configuration.
87
+ Do not ask the user a meta-question about whether they want questions.
88
+
89
+ - `auto` (default): autonomously use governed semantic context and schema discovery.
90
+ If unresolved ambiguity would materially change the result, ask one compact batch of
91
+ questions before querying; otherwise state the assumptions and proceed.
92
+ - `confirm`: first state the proposed interpretation and wait for the user's approval
93
+ before issuing the task's data query.
94
+ - `guided`: resolve the request through short, focused questions, carrying confirmed
95
+ answers forward rather than asking again.
96
+
97
+ For business requests, material ambiguity includes the requested result shape or grain,
98
+ metric definition, time boundary and timezone, inclusion/exclusion rules (such as order
99
+ status or refunds), grouping, or selected connection. Example: for “yesterday's sales,”
100
+ do not guess whether the user needs a total or detail, which timezone defines yesterday,
101
+ or whether cancelled and refunded orders count. Summarize the candidate interpretation
102
+ and ask only the unresolved, result-changing questions.
103
+
104
+ When the user explicitly says to decide without further questions, proceed in `auto`
105
+ mode and disclose the material assumptions. This never bypasses blacklist, schema,
106
+ permission, dry-run, production-selection, or write-confirmation gates; an agent must
107
+ still stop where those gates require human confirmation.
108
+
85
109
  **Business-language discovery:** When a user uses a business alias, metric, recurring
86
110
  term, or relationship/join intent instead of a physical table or field name, first run
87
111
  `dbcli skill context --format json`. If it includes `semantic`, treat that reviewed
@@ -82,6 +82,30 @@ warnings) go to stderr so stdout stays parseable — when piping JSON into a par
82
82
  use `2>/dev/null` or leave stderr alone. **Never `2>&1`**: it merges those lines back
83
83
  into stdout and the parse fails.
84
84
 
85
+ **Intent confirmation:** Treat `auto`, `confirm`, and `guided` as conversational
86
+ preferences for the current request, not as dbcli flags or persistent configuration.
87
+ Do not ask the user a meta-question about whether they want questions.
88
+
89
+ - `auto` (default): autonomously use governed semantic context and schema discovery.
90
+ If unresolved ambiguity would materially change the result, ask one compact batch of
91
+ questions before querying; otherwise state the assumptions and proceed.
92
+ - `confirm`: first state the proposed interpretation and wait for the user's approval
93
+ before issuing the task's data query.
94
+ - `guided`: resolve the request through short, focused questions, carrying confirmed
95
+ answers forward rather than asking again.
96
+
97
+ For business requests, material ambiguity includes the requested result shape or grain,
98
+ metric definition, time boundary and timezone, inclusion/exclusion rules (such as order
99
+ status or refunds), grouping, or selected connection. Example: for “yesterday's sales,”
100
+ do not guess whether the user needs a total or detail, which timezone defines yesterday,
101
+ or whether cancelled and refunded orders count. Summarize the candidate interpretation
102
+ and ask only the unresolved, result-changing questions.
103
+
104
+ When the user explicitly says to decide without further questions, proceed in `auto`
105
+ mode and disclose the material assumptions. This never bypasses blacklist, schema,
106
+ permission, dry-run, production-selection, or write-confirmation gates; an agent must
107
+ still stop where those gates require human confirmation.
108
+
85
109
  **Business-language discovery:** When a user uses a business alias, metric, recurring
86
110
  term, or relationship/join intent instead of a physical table or field name, first run
87
111
  `dbcli skill context --format json`. If it includes `semantic`, treat that reviewed