Merge branch 'main' into developer.md

Author: averikitsch

.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: |

.github/ISSUE_TEMPLATE/config.yml

@@ -1,3 +1,17 @@
+# 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

.github/sync-repo-settings.yaml

@@ -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

.github/workflows/header-check.yml

@@ -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"

.licenserc.yaml

@@ -6,20 +6,28 @@
 This Gemini CLI extension provides a set of tools to interact with [PostgreSQL](https://www.postgresql.org/docs/) instances. It allows you to manage your databases, execute queries, and explore schemas directly from the [Gemini CLI](https://google-gemini.github.io/gemini-cli/), using natural language prompts.
 
 Learn more about [Gemini CLI Extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md).
+> [!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=postgres
 
 ## Why Use the Postgres Extension?
 
-*   **Natural Language Management:** Stop wrestling with complex commands. Explore schemas and query data by describing what you want in plain English.
-*   **Seamless Workflow:** Stay in your CLI. No need to constantly switch contexts to the GCP console for common database tasks.
-*   **Code Generation:** Accelerate development by asking Gemini to generate data classes and other code snippets based on your table schemas.
+* **Natural Language Management:** Stop wrestling with complex commands. Explore schemas and query data by describing what you want in plain English.
+* **Seamless Workflow:** Stay in your CLI. No need to constantly switch contexts to the GCP console for common database tasks.
+* **Code Generation:** Accelerate development by asking Gemini to generate data classes and other code snippets based on your table schemas.
+
 
 ## Prerequisites
 
 Before you begin, ensure you have the following:
 
-*   [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version **+v0.6.0**.
-*   A running PostgreSQL instance.
-*   User are granted database-level permissions to execute queries.
+* [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 running PostgreSQL instance.
+* User are granted database-level permissions to execute queries.
 
 ## Getting Started
 
@@ -33,13 +41,13 @@ gemini extensions install https://github.com/gemini-cli-extensions/postgres
 
 ### 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.
 
-*   `POSTGRES_HOST`: The hostname or IP address of the PostgreSQL server.
-*   `POSTGRES_PORT`: The port number of the PostgreSQL server.
-*   `POSTGRES_DATABASE`: The name of the database to connect to.
-*   `POSTGRES_USER`: The username for authentication.
-*   `POSTGRES_PASSWORD`: The password for authentication.
+* `POSTGRES_HOST`: The hostname or IP address of the PostgreSQL server.
+* `POSTGRES_PORT`: The port number of the PostgreSQL server.
+* `POSTGRES_DATABASE`: The name of the database to connect to.
+* `POSTGRES_USER`: The username for authentication.
+* `POSTGRES_PASSWORD`: The password for authentication.
 
 ### Start Gemini CLI
 
@@ -58,12 +66,12 @@ gemini
 
 Interact with Postgres using natural language right from your IDE:
 
-*   **Explore Schemas and Data:**
+* **Explore Schemas and Data:**
     * "Show me all tables in the 'orders' database."
     * "What are the columns in the 'products' table?"
     * "How many orders were placed in the last 30 days, and what were the top 5 most purchased items?"
 
-*   **Generate Code:**
+* **Generate Code:**
     * "Generate a Python dataclass to represent the 'customers' table."
 
 ## Supported Tools
@@ -88,6 +96,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/postgres/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/postgres/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.

README.md

@@ -1 +1 @@
-0.16.0
+0.17.0