build: add pre-commit hooks and markdownlint configuration

Author: Trozz

.markdownlint.yaml

@@ -0,0 +1,14 @@
+# Markdownlint configuration
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+
+# Disable some overly strict rules
+MD033: false  # Inline HTML
+MD041: false  # First line in file should be a top level header
+MD024: false  # Multiple headers with the same content
+MD036: false  # Emphasis used instead of a header
+
+# Configure line length
+MD013:
+  line_length: 120
+  code_blocks: false
+  tables: false

.pre-commit-config.yaml

@@ -0,0 +1,69 @@
+# Pre-commit configuration for terraform-provider-pocketid
+# See https://pre-commit.com for more information
+repos:
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-added-large-files
+        args: ['--maxkb=500']
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: mixed-line-ending
+
+  # Go specific hooks
+  - repo: https://github.com/TekWizely/pre-commit-golang
+    rev: v1.0.0-rc.1
+    hooks:
+      - id: go-fmt
+      - id: go-vet-mod
+      - id: go-mod-tidy
+      - id: go-test-mod
+        args: ['-timeout=5m']
+      - id: go-build-mod
+      - id: golangci-lint-mod
+        args: ['--timeout=5m']
+
+  # Security scanning
+  - repo: https://github.com/trufflesecurity/trufflehog
+    rev: v3.89.2
+    hooks:
+      - id: trufflehog
+        name: TruffleHog
+        description: Detect secrets in your data.
+        entry: bash -c 'trufflehog git file://. --since-commit HEAD --only-verified --fail'
+        language: system
+        stages: ["commit", "push"]
+
+  # Terraform/HCL formatting
+  - repo: https://github.com/antonbabenko/pre-commit-terraform
+    rev: v1.99.4
+    hooks:
+      - id: terraform_fmt
+        args:
+          - --args=-recursive
+
+  # Markdown linting
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.45.0
+    hooks:
+      - id: markdownlint
+        args: ['--fix']
+
+  # Commit message validation
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.2.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args: [feat, fix, docs, style, refactor, test, chore, ci, build]
+
+# Global configuration
+fail_fast: false
+minimum_pre_commit_version: "3.0.0"