chore: add pre-commit hooks and auto-format codebase

- Add pre-commit configuration with comprehensive hooks
- Configure markdown linting with 120 char line limit
- Add hooks for trailing whitespace, end-of-file, and line endings
- Add Rust quality checks: cargo fmt, clippy, and check
- Add TOML formatting and validation
- Auto-format all files per pre-commit rules
- Update README with pre-commit documentation

Author: avrabe

.claude/settings.local.json

@@ -18,4 +18,4 @@
     ],
     "deny": []
   }
-}
+}

.github/workflows/release-npm.yml

@@ -75,17 +75,17 @@ jobs:
         run: |
           VERSION=${{ github.event.release.tag_name || github.event.inputs.version }}
           FILE="dist/timedate-mcp-server-${VERSION}-${{ matrix.target }}.${{ matrix.archive }}"
-          
+
           # Check if release exists, create if not
           if ! gh release view "${VERSION}" >/dev/null 2>&1; then
             gh release create "${VERSION}" --title "Release ${VERSION}" --notes "Auto-generated release for ${VERSION}"
           fi
-          
+
           # Upload or update asset
           if gh release view "${VERSION}" --json assets --jq '.assets[].name' | grep -q "timedate-mcp-server-${VERSION}-${{ matrix.target }}.${{ matrix.archive }}"; then
             gh release delete-asset "${VERSION}" "timedate-mcp-server-${VERSION}-${{ matrix.target }}.${{ matrix.archive }}" --yes
           fi
-          
+
           gh release upload "${VERSION}" "${FILE}"
 
   publish-npm:
@@ -108,7 +108,7 @@ jobs:
           VERSION=${{ github.event.release.tag_name || github.event.inputs.version }}
           # Remove 'v' prefix if present
           VERSION=${VERSION#v}
-          
+
           # Update main package version and optionalDependencies
           jq --arg version "$VERSION" '
             .version = $version |
@@ -183,18 +183,18 @@ jobs:
           VERSION=${{ github.event.release.tag_name || github.event.inputs.version }}
           ARCHIVE_EXT=${{ matrix.target == 'x86_64-pc-windows-msvc' && 'zip' || 'tar.gz' }}
           ASSET_NAME="timedate-mcp-server-${VERSION}-${{ matrix.target }}.${ARCHIVE_EXT}"
-          
+
           # Download the release asset
           gh release download "${VERSION}" --pattern "${ASSET_NAME}" --dir ./temp
-          
+
           # Extract the binary
           cd temp
           if [[ "${ARCHIVE_EXT}" == "zip" ]]; then
             unzip "${ASSET_NAME}"
           else
             tar -xzf "${ASSET_NAME}"
           fi
-          
+
           # Move binary to platform package directory
           mv "${{ matrix.binary }}" "../timedate-mcp-server/platform-packages/${{ matrix.platform }}/"
 
@@ -204,7 +204,7 @@ jobs:
           VERSION=${{ github.event.release.tag_name || github.event.inputs.version }}
           # Remove 'v' prefix if present
           VERSION=${VERSION#v}
-          
+
           # Update platform package version
           jq --arg version "$VERSION" '.version = $version' package.json > package.json.tmp && mv package.json.tmp package.json
 
@@ -215,4 +215,4 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
       - name: Clean up
-        run: rm -rf temp
+        run: rm -rf temp

.gitignore

@@ -28,4 +28,4 @@ build/
 bin/
 
 # Authentication
-~/.pulseengine/
+~/.pulseengine/

.markdownlint.json

@@ -0,0 +1,10 @@
+{
+  "default": true,
+  "MD013": {
+    "line_length": 120,
+    "code_blocks": false,
+    "tables": false
+  },
+  "MD033": false,
+  "MD041": false
+}

.pre-commit-config.yaml

@@ -0,0 +1,70 @@
+# Pre-commit hooks configuration
+# Install: pip install pre-commit
+# Setup: pre-commit install
+# Run manually: pre-commit run --all-files
+
+repos:
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        exclude: '\.lock$'
+      - id: end-of-file-fixer
+        exclude: '\.lock$'
+      - id: check-yaml
+        args: ['--unsafe']  # Allow custom YAML tags
+      - id: check-json
+      - id: check-toml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-merge-conflict
+      - id: check-case-conflict
+      - id: mixed-line-ending
+        args: ['--fix=lf']
+
+  # Markdown linting
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.42.0
+    hooks:
+      - id: markdownlint
+        args: ['--fix']
+
+  # Rust formatting
+  - repo: local
+    hooks:
+      - id: cargo-fmt
+        name: cargo fmt
+        entry: cargo fmt
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+  # Rust linting
+  - repo: local
+    hooks:
+      - id: cargo-clippy
+        name: cargo clippy
+        entry: cargo clippy
+        args: ['--all-targets', '--all-features', '--', '-D', 'warnings']
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+  # Rust security audit (optional - can be slow)
+  - repo: local
+    hooks:
+      - id: cargo-check
+        name: cargo check
+        entry: cargo check
+        args: ['--all-targets', '--all-features']
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+  # TOML sorting and formatting
+  - repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
+    rev: v2.14.0
+    hooks:
+      - id: pretty-format-toml
+        args: ['--autofix']

Cargo.toml

@@ -1,24 +1,24 @@
 [workspace]
 members = [
-    "timedate-mcp-server"
+  "timedate-mcp-server"
 ]
 resolver = "2"
 
 [workspace.dependencies]
-tokio = { version = "1.0", features = ["full"] }
-serde = { version = "1.0", features = ["derive"] }
-serde_json = "1.0"
-chrono = { version = "0.4", features = ["serde"] }
-chrono-tz = "0.10"
-tracing = "0.1"
-tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 anyhow = "1.0"
-thiserror = "1.0"
-clap = { version = "4.0", features = ["derive"] }
 async-trait = "0.1"
-schemars = { version = "1.0", features = ["chrono04"] }
-# Use published framework version 0.11.0
-pulseengine-mcp-server = { version = "0.11.0", features = ["stdio-logging"] }
+chrono = {version = "0.4", features = ["serde"]}
+chrono-tz = "0.10"
+clap = {version = "4.0", features = ["derive"]}
 pulseengine-mcp-macros = "0.11.0"
 pulseengine-mcp-protocol = "0.11.0"
+# Use published framework version 0.11.0
+pulseengine-mcp-server = {version = "0.11.0", features = ["stdio-logging"]}
 pulseengine-mcp-transport = "0.11.0"
+schemars = {version = "1.0", features = ["chrono04"]}
+serde = {version = "1.0", features = ["derive"]}
+serde_json = "1.0"
+thiserror = "1.0"
+tokio = {version = "1.0", features = ["full"]}
+tracing = "0.1"
+tracing-subscriber = {version = "0.3", features = ["env-filter"]}

LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

README.md

@@ -1,12 +1,13 @@
 # TimeDate MCP Server
 
-A Model Context Protocol (MCP) server providing comprehensive time and date operations with timezone support, built with Rust and the PulseEngine MCP framework.
+A Model Context Protocol (MCP) server providing comprehensive time and date operations with timezone support,
+built with Rust and the PulseEngine MCP framework.
 
 ## Features
 
 - **Current Time**: Get current time in any timezone
 - **Time Calculations**: Add/subtract time from dates
-- **Timezone Conversion**: Convert time between different timezones  
+- **Timezone Conversion**: Convert time between different timezones
 - **Timezone Information**: Get detailed timezone data including DST status
 - **Time Format Detection**: Detect and work with 12-hour/24-hour formats
 - **Timezone Listing**: Browse available timezones with filtering
@@ -29,44 +30,56 @@ timedate-mcp-server
 ## Available Tools
 
 ### `get_current_time`
+
 Get the current time in the specified timezone (defaults to system timezone).
 
 **Parameters:**
+
 - `timezone` (optional): Target timezone (e.g., "America/New_York", "Europe/London")
 
 ### `get_time_at`
+
 Get time at a specific date and timezone.
 
 **Parameters:**
+
 - `date_time`: Date/time string (RFC3339, "YYYY-MM-DD HH:MM:SS", or "YYYY-MM-DD")
 - `timezone` (optional): Target timezone
 
 ### `calculate_time_offset`
+
 Add or subtract time from a given date.
 
 **Parameters:**
+
 - `base_time`: Base time ("now" or date string)
 - `offset_hours`: Hours to add (positive) or subtract (negative)
 - `timezone` (optional): Target timezone
 
 ### `get_timezone_info`
+
 Get information about the current system timezone.
 
 ### `convert_timezone`
+
 Convert time between different timezones.
 
 **Parameters:**
+
 - `time`: Time to convert ("now" or date string)
 - `from_timezone`: Source timezone
 - `to_timezone`: Target timezone
 
 ### `get_time_format`
+
 Detect time format preference (12-hour vs 24-hour).
 
 ### `list_timezones`
+
 List available timezones with optional filtering.
 
 **Parameters:**
+
 - `filter` (optional): Filter string to match timezone names
 
 ## Example Usage
@@ -75,10 +88,10 @@ List available timezones with optional filtering.
 // Get current time in Tokyo
 await server.get_current_time({ timezone: "Asia/Tokyo" });
 
-// Convert New York time to London time  
+// Convert New York time to London time
 await server.convert_timezone({
   time: "2024-01-15 14:30:00",
-  from_timezone: "America/New_York", 
+  from_timezone: "America/New_York",
   to_timezone: "Europe/London"
 });
 
@@ -93,6 +106,7 @@ await server.calculate_time_offset({
 ## Response Format
 
 All time responses include:
+
 - `timestamp`: ISO 8601/RFC3339 formatted time
 - `timezone`: Timezone identifier
 - `utc_offset`: UTC offset (e.g., "+0900", "-0500")
@@ -132,9 +146,35 @@ npm run build:darwin-arm64
 npm run build:win32-x64
 ```
 
+### Pre-commit Hooks
+
+This project uses pre-commit hooks to ensure code quality:
+
+```bash
+# Install pre-commit (if not already installed)
+pip install pre-commit
+
+# Install git hooks
+pre-commit install
+
+# Run manually on all files
+pre-commit run --all-files
+```
+
+**Hooks included:**
+
+- Trailing whitespace removal
+- End-of-file fixing
+- YAML/JSON/TOML validation
+- Markdown linting
+- Rust formatting (cargo fmt)
+- Rust linting (cargo clippy)
+- Rust compilation check
+
 ## Architecture
 
 Built using:
+
 - **Rust**: Core implementation for performance and safety
 - **PulseEngine MCP Framework**: MCP protocol implementation with macros
 - **Chrono & Chrono-TZ**: Comprehensive timezone and datetime handling
@@ -146,4 +186,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Contributing
 
-Contributions welcome! Please read our contributing guidelines and submit pull requests to our [GitHub repository](https://github.com/pulseengine/timedate-mcp).
+Contributions welcome! Please read our contributing guidelines and submit pull requests to our [GitHub repository](https://github.com/pulseengine/timedate-mcp).

package.json

@@ -4,7 +4,7 @@
   "description": "A Model Context Protocol server for time and date operations with timezone support",
   "keywords": [
     "mcp",
-    "model-context-protocol", 
+    "model-context-protocol",
     "time",
     "date",
     "timezone",
@@ -35,7 +35,7 @@
     "build": "cargo build --release",
     "build:all": "npm run build:linux-x64 && npm run build:darwin-x64 && npm run build:darwin-arm64 && npm run build:win32-x64",
     "build:linux-x64": "cargo build --release --target x86_64-unknown-linux-gnu",
-    "build:darwin-x64": "cargo build --release --target x86_64-apple-darwin", 
+    "build:darwin-x64": "cargo build --release --target x86_64-apple-darwin",
     "build:darwin-arm64": "cargo build --release --target aarch64-apple-darwin",
     "build:win32-x64": "cargo build --release --target x86_64-pc-windows-gnu",
     "test": "cargo test",
@@ -51,11 +51,11 @@
   },
   "optionalDependencies": {
     "@pulseengine/timedate-mcp-server-linux-x64": "0.1.0",
-    "@pulseengine/timedate-mcp-server-darwin-x64": "0.1.0", 
+    "@pulseengine/timedate-mcp-server-darwin-x64": "0.1.0",
     "@pulseengine/timedate-mcp-server-darwin-arm64": "0.1.0",
     "@pulseengine/timedate-mcp-server-win32-x64": "0.1.0"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}