chore(security): add gitleaks pre-commit hook and CI workflow

.github/workflows/gitleaks.yml

@@ -0,0 +1,33 @@
+name: gitleaks
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  schedule:
+    - cron: "17 3 * * 1"  # weekly full-history sweep (Mondays 03:17 UTC)
+
+permissions:
+  contents: read
+
+jobs:
+  scan:
+    name: scan for leaked secrets
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          # Full history is required so the scanner can audit every commit on PRs
+          # and on the weekly cron sweep, not just the diff.
+          fetch-depth: 0
+
+      - name: Run gitleaks
+        uses: gitleaks/gitleaks-action@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITLEAKS_CONFIG: .gitleaks.toml
+          # Fail the job on any finding; report (SARIF) is uploaded to the
+          # Code Scanning tab so reviewers can see redacted matches inline.
+          GITLEAKS_ENABLE_UPLOAD_ARTIFACT: "true"
+          GITLEAKS_ENABLE_SUMMARY: "true"

.gitleaks.toml

@@ -0,0 +1,67 @@
+title = "VideoVault gitleaks config"
+
+# Inherit gitleaks' default rule set, then add provider rules tailored to
+# this repo (HF tokens, the AWS key formats we have leaked before).
+[extend]
+useDefault = true
+
+# ── Custom rules ────────────────────────────────────────────────────────────
+
+[[rules]]
+id = "huggingface-user-access-token"
+description = "Hugging Face user access token (hf_<37 chars>)"
+regex = '''\bhf_[A-Za-z0-9]{30,}\b'''
+tags = ["secret", "huggingface", "token"]
+
+[[rules]]
+id = "huggingface-org-token"
+description = "Hugging Face org token (hf_org_<...>)"
+regex = '''\bhf_org_[A-Za-z0-9]{30,}\b'''
+tags = ["secret", "huggingface", "token"]
+
+[[rules]]
+id = "aws-access-key-id-strict"
+description = "AWS access key ID (AKIA/ASIA/AROA/AIDA prefix)"
+regex = '''\b(?:AKIA|ASIA|AROA|AIDA)[0-9A-Z]{16}\b'''
+tags = ["secret", "aws", "key"]
+
+[[rules]]
+id = "aws-secret-access-key-assignment"
+description = "AWS secret access key assignment (40-char base64-ish near an aws_secret hint)"
+regex = '''(?i)aws[_\-]?secret[_\-]?access[_\-]?key["'\s:=]{1,5}[A-Za-z0-9/+]{40}'''
+tags = ["secret", "aws", "key"]
+
+[[rules]]
+id = "google-oauth-client-secret"
+description = "Google OAuth client secret (GOCSPX-<...>)"
+regex = '''\bGOCSPX-[A-Za-z0-9_\-]{20,}\b'''
+tags = ["secret", "google", "oauth"]
+
+# ── Allowlist (false-positive suppression, not real secret allowlisting) ──
+
+[allowlist]
+description = "Paths and patterns the scanner should ignore"
+paths = [
+  '''(^|/)\.gitleaks\.toml$''',          # this file
+  '''(^|/)\.github/workflows/gitleaks''',  # CI definition references the rules
+  '''(^|/)README\.md$''',                # docs that may quote example shapes
+  '''(^|/)docs/''',                      # design docs may show example token shapes
+  '''(^|/)\.env\.example$''',
+  '''(^|/).*\.env\.example$''',
+  '''node_modules/''',
+  '''package-lock\.json$''',
+  '''graphify-out/''',
+  '''tests/bench/data/''',               # downloaded dataset
+  '''tests/bench/runs/''',               # local benchmark outputs
+]
+
+# Well-known non-secret placeholders we never want to flag.
+regexes = [
+  '''your-aws-access-key-id''',
+  '''your-aws-secret-access-key''',
+  '''your-google-oauth2-client-secret''',
+  '''minioadmin''',                      # MinIO well-known local-dev default
+  '''videovault''',                      # local POSTGRES_PASSWORD default
+  '''AKIAIOSFODNN7EXAMPLE''',            # AWS docs canonical example
+  '''wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY''',  # AWS docs canonical example
+]

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.21.2
+    hooks:
+      - id: gitleaks
+        name: gitleaks (block secrets before commit)
+        args: ["protect", "--staged", "--redact", "--config=.gitleaks.toml"]