Infrastructure: Add formatting configs and scripts

Author: josemontespg

.editorconfig

@@ -0,0 +1,22 @@
+# Copyright 2026 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.
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+insert_final_newline = true

.github/workflows/enforce-formatting.yml

@@ -0,0 +1,45 @@
+# Copyright 2026 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
+#
+#      https://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: Enforce Formatting
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  enforce-formatting:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install `uv` globally
+        run: |
+          python -m pip install --upgrade pip
+          pip install uv
+
+      - name: Run enforce-formatting script
+        run: ./scripts/fix_format.sh --check

.prettierignore

@@ -0,0 +1,23 @@
+# Copyright 2026 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.
+
+node_modules
+dist
+build
+.git
+.dart_tool
+.venv
+*.min.js
+agent_sdks/conformance/test_data/**
+**/pnpm-lock.yaml

.prettierrc

@@ -0,0 +1,24 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "semi": true,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "bracketSpacing": false,
+  "jsxSingleQuote": false,
+  "arrowParens": "avoid",
+  "overrides": [
+    {
+      "files": "*.html",
+      "options": {
+        "parser": "angular"
+      }
+    },
+    {
+      "files": ["*.yaml", "*.yml"],
+      "options": {
+        "singleQuote": false
+      }
+    }
+  ]
+}

.vscode/settings.json

@@ -1,3 +1,12 @@
 {
-  "dart.projectSearchDepth": 10
+  "dart.projectSearchDepth": 10,
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter"
+  },
+  "black-formatter.path": ["pyink"],
+  "[dart]": {
+    "editor.defaultFormatter": "Dart-Code.dart-code"
+  }
 }

CONTRIBUTING.md

@@ -41,7 +41,7 @@ You may follow these steps to contribute:
 3. **Work on your forked repository's feature branch.** This is where you will make your changes to the code.
 4. **Commit your updates on your forked repository's feature branch.** This will save your changes to your copy of the repository.
 5. **Submit a pull request to the official repository's main branch.** This will request that your changes be merged into the official repository.
-6. **Resolve any linting errors.** This will ensure that your changes are formatted correctly.
+6. **Resolve any linting and formatting errors.** Run `./scripts/fix_format.sh` to fix formatting issues.
 
 Here are some additional things to keep in mind during the process:
 
@@ -50,12 +50,36 @@ Here are some additional things to keep in mind during the process:
 
 ## Coding Style
 
-To keep our codebase consistent and maintainable, we follow specific coding standards for Python and TypeScript.
+To keep our codebase consistent and maintainable, we follow specific coding standards and use automated formatters.
 
-Please refer to the following guidelines for detailed information on:
-*   **Python**: [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html).
-*   **TypeScript**: usage of [`gts`](https://github.com/google/gts) and [Google TypeScript Style Guide](https://google.github.io/styleguide/tsguide.html).
-*   **License Headers**: required copyright notices.
+### Formatters
+
+- **JavaScript / TypeScript / JSON / Markdown / CSS**: [Prettier](https://prettier.io/)
+- **Python**: [Pyink](https://github.com/google/pyink) (Google style Black)
+- **Dart**: `dart format`
+
+You can use the provided script to format the entire repo or check formatting:
+
+```bash
+./scripts/fix_format.sh
+./scripts/fix_format.sh --check
+```
+
+### IDE Recommendations (VS Code)
+
+We recommend using [VS Code](https://code.visualstudio.com/) for development. To help enforce formatting, please install the following extensions:
+
+- **Prettier - Code formatter** (`esbenp.prettier-vscode`)
+- **Black Formatter** (`ms-python.black-formatter`) - configured to use `pyink` in workspace settings.
+- **Dart** (`Dart-Code.dart-code`)
+
+Workspace settings are provided in `.vscode/settings.json` to use these formatters by default on save.
+
+Please refer to the following guidelines for detailed information on styles:
+
+- **Python**: [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html).
+- **TypeScript**: [Google TypeScript Style Guide](https://google.github.io/styleguide/tsguide.html).
+- **License Headers**: required copyright notices.
 
 We expect all contributors to adhere to these styles.