Merge branch 'main' into developer.md

averikitsch · web-flow · commit eca9acb153f1 · 2025-10-15T09:54:56.000-07:00
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -38,7 +38,7 @@ body:
         - label: "I've updated to the latest versions"
 
   - type: input
-    id: version
+    id: ex_version
     attributes:
       label: Extension Version
       description: |
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,3 +1,18 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
 blank_issues_enabled: false
 contact_links:
   - name: Google Cloud Support
diff --git a/.github/sync-repo-settings.yaml b/.github/sync-repo-settings.yaml
diff --git a/.github/workflows/header-check.yml b/.github/workflows/header-check.yml
@@ -0,0 +1,30 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: 'License Header Check'
+
+on:
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  license-check:
+    name: 'License Header Check'
+    runs-on: ubuntu-latest
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@v5
+
+      - name: Check License Header
+        uses: apache/skywalking-eyes/header@v0.7.0
diff --git a/.licenserc.yaml b/.licenserc.yaml
@@ -0,0 +1,22 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+header:
+  license:
+    spdx-id: "Apache-2.0"
+    copyright-owner: "Google LLC"
+  paths:
+    - "**/*.yaml"
+    - "**/*.yml"
+    - "**/*.toml"
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.1.1"
+  ".": "0.1.2"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.2](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/compare/0.1.1...0.1.2) (2025-10-13)
+
+
+### Features
+
+* add full table name to context file ([#35](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/issues/35)) ([984b098](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/commit/984b09830b67a346bf3d9222b88622bd37fa7415))
+* **deps:** update dependency googleapis/genai-toolbox to v0.17.0 ([#42](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/issues/42)) ([946fc11](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/commit/946fc11399c4131d3c3892c373e428accb90d172))
+
 ## [0.1.1](https://github.com/gemini-cli-extensions/cloud-sql-sqlserver/compare/0.1.0...0.1.1) (2025-09-30)
 
 
diff --git a/README.md b/README.md
@@ -13,12 +13,21 @@ Learn more about [Gemini CLI Extensions](https://github.com/google-gemini/gemini
 * **Natural Language Management:** Stop wrestling with complex commands. Explore schemas and query data by describing what you want in plain English.
 * **Code Generation:** Accelerate development by asking Gemini to generate data classes and other code snippets based on your table schemas.
 
+> [!IMPORTANT]
+> **We Want Your Feedback!**
+> Please share your thoughts with us by filling out our feedback [form][form]. 
+> Your input is invaluable and helps us improve the project for everyone.
+
+[form]: https://docs.google.com/forms/d/e/1FAIpQLSfEGmLR46iipyNTgwTmIDJqzkAwDPXxbocpXpUbHXydiN1RTw/viewform?usp=pp_url&entry.157487=cloud-sql-sqlserver
+
 ## Prerequisites
 
 Before you begin, ensure you have the following:
 
 * [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version **+v0.6.0**.
+* Setup Gemini CLI [Authentication](https://github.com/google-gemini/gemini-cli/tree/main?tab=readme-ov-file#-authentication-options).
 * A Google Cloud project with the **Cloud SQL Admin API** enabled.
+* Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.
 * IAM Permissions:
   * Cloud SQL Client (`roles/cloudsql.client`)
   * Cloud SQL Viewer (`roles/cloudsql.viewer`)
@@ -36,7 +45,7 @@ gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-sql
 
 ### Configuration
 
-Set the following environment variables before starting the Gemini CLI.
+Set the following environment variables before starting the Gemini CLI. These variables can be loaded from a `.env` file.
 This configuration is not required if utilizing the [Admin toolset](#supported-tools).
 
 * `CLOUD_SQL_MSSQL_PROJECT`: The GCP project ID.
@@ -66,45 +75,6 @@ gemini
 > Currently, the database connection must be configured before starting the Gemini CLI and can not be changed during a session.
 > To save and resume conversation history use command: `/chat save <tag>` and `/chat resume <tag>`.
 
-### Start Gemini CLI
-
-To start the Gemini CLI, use the following command:
-
-```bash
-gemini
-```
-
-> [!WARNING]
-> **Changing Instance & Database Connections**
-> Currently, the database connection must be configured before starting the Gemini CLI and can not be changed during a session.
-> To save and resume conversation history use command: `/chat save <tag>` and `/chat resume <tag>`.
-
-### Start Gemini CLI
-
-To start the Gemini CLI, use the following command:
-
-```bash
-gemini
-```
-
-> [!WARNING]
-> **Changing Instance & Database Connections**
-> Currently, the database connection must be configured before starting the Gemini CLI and can not be changed during a session.
-> To save and resume conversation history use command: `/chat save <tag>` and `/chat resume <tag>`.
-
-### Start Gemini CLI
-
-To start the Gemini CLI, use the following command:
-
-```bash
-gemini
-```
-
-> [!WARNING]
-> **Changing Instance & Database Connections**
-> Currently, the database connection must be configured before starting the Gemini CLI and can not be changed during a session.
-> To save and resume conversation history use command: `/chat save <tag>` and `/chat resume <tag>`.
-
 ## Usage Examples
 
 Interact with Cloud SQL for SQL Server using natural language:
@@ -121,7 +91,7 @@ Interact with Cloud SQL for SQL Server using natural language:
 
 ## Supported Tools
 
-*   **Admin:**
+* **Admin:**
    	* `create_instance`: Use this tool to create an SQL Server instance.
    	* `create_user`: Use this tool to create SQL Server-BUILT-IN or IAM-based users.
    	* `get_instance`: Use this tool to get details about an SQL Server instance.
@@ -130,7 +100,7 @@ Interact with Cloud SQL for SQL Server using natural language:
    	* `list_users`: Use this tool to list users in a given project and location.
     * `wait_for_operation`: Use this tool to poll the operations API until the operation is done.
 
-*   **Data:**
+* **Data:**
     * `list_tables`: Use this tool to list tables and descriptions.
     * `execute_sql`: Use this tool to execute any SQL statement.
 
@@ -143,6 +113,11 @@ Find additional extensions to support your entire software development lifecycle
 
 ## Troubleshooting
 
+Use `gemini --debug` to enable debugging.
+
+Common issues:
+
+* "failed to find default credentials: google: could not find default credentials.": Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment. See [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/external/set-up-adc) for more information.
 * "✖ Error during discovery for server: MCP error -32000: Connection closed": The database connection has not been established. Ensure your configuration is set via environment variables.
-* "✖ MCP ERROR: Error: spawn /Users/<USER>/.gemini/extensions/cloud-sql-sqlserver/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.
+* "✖ MCP ERROR: Error: spawn /Users/USER/.gemini/extensions/cloud-sql-sqlserver/toolbox ENOENT": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.
 * "cannot execute binary file": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information.
diff --git a/gemini-extension.json b/gemini-extension.json
@@ -1,6 +1,6 @@
 {
   "name": "cloud-sql-sqlserver",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Connect to Cloud SQL for SQL Server",
   "mcpServers": {
     "cloud_sql_sqlserver_admin": {
diff --git a/toolbox_version.txt b/toolbox_version.txt
@@ -1 +1 @@
-0.16.0
+0.17.0

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.1.1"`
	`2`	`+ ".": "0.1.2"`
`3`	`3`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "cloud-sql-sqlserver",`
`3`		`- "version": "0.1.1",`
	`3`	`+ "version": "0.1.2",`
`4`	`4`	`"description": "Connect to Cloud SQL for SQL Server",`
`5`	`5`	`"mcpServers": {`
`6`	`6`	`"cloud_sql_sqlserver_admin": {`